Benutzerdefinierte Such-API-v7-ReferenzCustom Search API v7 reference

Mit der benutzerdefinierten Such-API können Sie eine Suchabfrage an Bing senden und Webseiten aus dem Websegment abrufen, das Von Ihrer benutzerdefinierten Suchinstanz definiert wird.The Custom Search API lets you send a search query to Bing and get back web pages from the slice of Web that your Custom Search instance defines. Weitere Informationen zum Konfigurieren einer Instanz der benutzerdefinierten Suche finden Sie unter Konfigurieren der Benutzeroberfläche für die benutzerdefinierte Suche.For information about configuring a Custom Search instance, see Configure your custom search experience.

Informationen zu Headern, die Anforderungen enthalten sollten, finden Sie unter Anforderungsheader.For information about headers that requests should include, see Request Headers.

Informationen zu Abfrageparametern, die Anforderungen enthalten sollten, finden Sie unter Abfrageparameter.For information about query parameters that requests should include, see Query Parameters.

Informationen zu den JSON-Objekten, die die Antwort enthalten kann, finden Sie unter Antwortkörper.For information about the JSON objects that the response may include, see Response Body.

Informationen zur zulässigen Verwendung und Anzeige von Ergebnissen finden Sie unter Bing Search API Use and Display requirements.For information about permitted use and display of results, see Bing Search API Use and Display requirements.

Hinweis

Da sich URL-Formate und -Parameter ohne Vorankündigung ändern können, sollten Sie alle URLs in der vorliegenden Form verwenden.Because URL formats and parameters are subject to change without notice, use all URLs as-is. Es sollten keine Abhängigkeiten von URL-Formaten oder -Parametern bestehen, außer wenn dies angegeben ist.You should not take dependencies on the URL format or parameters except where noted.

EndpunkteEndpoints

Um Suchergebnisse aus Ihrer benutzerdefinierten Ansicht des Webs anzufordern, senden Sie eine GET-Anforderung an:To request search results from your custom view of the web, send a GET request to:

https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search

Bei Abonnements mit mehreren Diensten müssen Sie die Region in die URL aufnehmen.For multi-service subscriptions, you must include the region in the URL. Beispiel: westus.api.cognitive.microsoft.com.For example: westus.api.cognitive.microsoft.com. Siehe Unterstützte Regionen.See Supported Regions.

Die Anforderung muss das HTTPS-Protokoll verwenden.The request must use the HTTPS protocol.

Hinweis

Die maximale URL-Länge beträgt 2.048 Zeichen.The maximum URL length is 2,048 characters. Um sicherzustellen, dass die URL-Länge diesen Grenzwert nicht überschreitet, sollte die maximale Länge Ihrer Abfrageparameter weniger als 1.500 Zeichen betragen.To ensure that your URL length does not exceed the limit, the maximum length of your query parameters should be less than 1,500 characters. Wenn die URL länger als 2.048 Zeichen ist, gibt der Server „404: Nicht gefunden“ zurück.If the URL exceeds 2,048 characters, the server returns 404 Not found.

HeaderHeaders

Die folgenden Header kann eine Anforderung und Antwort möglicherweise enthalten.The following are the headers that a request and response may include.

HeaderHeader BeschreibungDescription
AkzeptierenAccept Optionaler Anforderungsheader.Optional request header.

Der Standardmedientyp ist application/json.The default media type is application/json. Um anzugeben, dass die Antwort JSON-LD verwenden soll, legen Sie den Accept-Header auf application/ld+json fest.To specify that the response use JSON-LD, set the Accept header to application/ld+json.
Accept-LanguageAccept-Language Optionaler Anforderungsheader.Optional request header.

Eine durch Kommas getrennte Liste mit Sprachen, die für Zeichenfolgen der Benutzeroberfläche verwendet werden sollen.A comma-delimited list of languages to use for user interface strings. Die Liste ist absteigend nach Präferenz sortiert.The list is in decreasing order of preference. Weitere Informationen hierzu (sowie zum erwarteten Format) finden Sie unter RFC2616.For more information, including expected format, see RFC2616.

Dieser Header und der Abfrageparameter setLang— schließen sich gegenseitig aus. Geben Sie daher nicht beide an.This header and the setLang query parameter are mutually exclusive—do not specify both.

Wenn Sie diesen Header festlegen, cc müssen Sie auch den cc-Abfrageparameter angeben.If you set this header, you must also specify the cc query parameter. Bing verwendet die erste unterstützte Sprache aus der Liste, um den Markt zu bestimmen, für den Ergebnisse zurückgegeben werden sollen, und kombiniert sie mit dem Parameterwert cc.To determine the market to return results for, Bing uses the first supported language it finds from the list and combines it with the cc parameter value. Enthält die Liste keine unterstützte Sprache, sucht Bing die nächstgelegene Sprache und den nächstgelegenen Markt, die bzw. der die Anforderung unterstützt. Alternativ dazu wird für die Ergebnisse ein aggregierter oder Standardmarkt verwendet.If the list does not include a supported language, Bing finds the closest language and market that supports the request or it uses an aggregated or default market for the results. Wenn Sie sehen möchten, welchen Markt Bing verwendet hat, untersuchen Sie den Header „BingAPIs-Market“.To determine the market that Bing used, see the BingAPIs-Market header.

Verwenden Sie den Accept-Language-Header und den cc Abfrageparameter nur, wenn Sie mehrere Sprachen angeben.Use Accept-Language header and the cc query parameter only if you specify multiple languages. Verwenden Sie andernfalls die Abfrageparameter mkt und setLang.Otherwise, use the mkt and setLang query parameters.

Eine Zeichenfolge der Benutzeroberfläche ist eine Zeichenfolge, die als Bezeichnung in einer Benutzeroberfläche verwendet wird.A user interface string is a string that's used as a label in a user interface. Die JSON-Antwortobjekte enthalten nur wenige Zeichenfolgen für Benutzeroberflächen.There are few user interface strings in the JSON response objects. Die Links zu Eigenschaften von „bing.com“ in den Antwortobjekten verwenden die angegebene Sprache.Any links to Bing.com properties in the response objects apply the specified language.
BingAPIs-MarketBingAPIs-Market Antwortheader.Response header.

Der von der Anforderung verwendete Markt.The market used by the request. Das Format lautet <Sprachcode>-<Ländercode>.The form is <languageCode>-<countryCode>. Beispiel: en-US.For example, en-US.

Wenn Sie einen Markt angeben, der nicht in Market Codesaufgeführt ist, kann dieser Wert vom Markt abweichen, den Sie im mkt-Abfrageparameter angegeben haben.If you specify a market that is not listed in Market Codes, this value may differ from the market you specified in the mkt query parameter. Dasselbe gilt, wenn Sie Werte für cc und Accept-Language angeben, die nicht abgestimmt werden können.The same is true if you specify values for cc and Accept-Language that can't be reconciled.
BingAPIs-TraceIdBingAPIs-TraceId Antwortheader.Response header.

Die ID des Protokolleintrags, der die Details der Anforderung enthält.The ID of the log entry that contains the details of the request. Erfassen Sie diese ID, wenn ein Fehler auftritt.When an error occurs, capture this ID. Wenn Sie das Problem nicht ermitteln und beheben können, übermitteln Sie diese ID und weitere Informationen an das Supportteam.If you are not able to determine and resolve the issue, include this ID along with the other information that you provide the Support team.
Ocp-Apim-Subscription-KeyOcp-Apim-Subscription-Key Erforderlicher Anforderungsheader.Required request header.

Der Abonnementschlüssel, den Sie bei der Registrierung für diesen Dienst in Cognitive Services erhalten haben.The subscription key that you received when you signed up for this service in Cognitive Services.
Retry-AfterRetry-After Antwortheader.Response header.

Die Antwort enthält diesen Header, wenn Sie die Anzahl der zulässigen Abfragen pro Sekunde (QPS) oder pro Monat (QPM) überschreiten.The response includes this header if you exceed the number of queries allowed per second (QPS) or per month (QPM). Der Header enthält die Anzahl der Sekunden, die Sie warten müssen, bevor Sie eine weitere Anforderung senden.The header contains the number of seconds that you must wait before sending another request.
User-AgentUser-Agent Optionaler Anforderungsheader.Optional request header.

Der Benutzer-Agent, von dem die Anforderung stammt.The user agent originating the request. Bing verwendet den Benutzer-Agent, um die Erfahrung mobiler Benutzer zu optimieren.Bing uses the user agent to provide mobile users with an optimized experience. Auch wenn dies optional ist, sollten Sie diesen Header immer angeben.Although optional, you are encouraged to always specify this header.

Der Benutzer-Agent sollte der Zeichenfolge entsprechen, die alle häufig verwendeten Browser senden.The user-agent should be the same string that any commonly used browser sends. Informationen zu Benutzer-Agents finden Sie in RFC 2616.For information about user agents, see RFC 2616.

Nachfolgend einige Beispiele für Zeichenfolgen für Benutzer-Agents.The following are examples of user-agent strings.
  • Windows Phone—Mozilla/5.0 (kompatibel; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)Windows Phone—Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)

  • Android—Mozilla/5.0 (Linux; U; Android 2.3.5; en-US; SCH-I500 Build/GINGERBREAD) AppleWebKit/533.1 (KHTML; wie Gecko) Version/4.0 Mobile Safari/533.1Android—Mozilla/5.0 (Linux; U; Android 2.3.5; en-us; SCH-I500 Build/GINGERBREAD) AppleWebKit/533.1 (KHTML; like Gecko) Version/4.0 Mobile Safari/533.1

  • iPhone—Mozilla/5.0 (iPhone; CPU iPhone OS 6_1 wie Mac OS X) AppleWebKit/536.26 (KHTML; wie Gecko) Mobile/10B142 iPhone4;1 BingWeb/3.03.1428.20120423iPhone—Mozilla/5.0 (iPhone; CPU iPhone OS 6_1 like Mac OS X) AppleWebKit/536.26 (KHTML; like Gecko) Mobile/10B142 iPhone4;1 BingWeb/3.03.1428.20120423

  • PC—Mozilla/5.0 (Windows NT 6.3; WOW64; Trident/7.0; Touch; rv:11.0) wie GeckoPC—Mozilla/5.0 (Windows NT 6.3; WOW64; Trident/7.0; Touch; rv:11.0) like Gecko

  • iPad—Mozilla/5.0 (iPad; CPU OS 7_0 wie Mac OS X) AppleWebKit/537.51.1 (KHTML, wie Gecko) Version/7.0 Mobile/11A465 Safari/9537.53iPad—Mozilla/5.0 (iPad; CPU OS 7_0 like Mac OS X) AppleWebKit/537.51.1 (KHTML, like Gecko) Version/7.0 Mobile/11A465 Safari/9537.53
X-MSEdge-ClientIDX-MSEdge-ClientID Optionaler Anforderungs- und Antwortheader.Optional request and response header.

Bing verwendet diesen Header, um Benutzern beim Aufrufen der Bing-API ein konsistentes Verhalten bereitzustellen.Bing uses this header to provide users with consistent behavior across Bing API calls. Bing testet häufig neue Funktionen und Verbesserungen und verwendet dabei die Client-ID als Schlüssel für die Zuweisung von Datenverkehr an verschiedene Flights.Bing often flights new features and improvements, and it uses the client ID as a key for assigning traffic on different flights. Wenn Sie für einen Benutzer bei unterschiedlichen Anforderungen nicht dieselbe Client-ID verwenden, weist Bing den Benutzer möglicherweise mehreren widersprüchlichen Flights zu.If you do not use the same client ID for a user across multiple requests, then Bing may assign the user to multiple conflicting flights. Die Zuweisung zu mehreren widersprüchlichen Flights kann zu einer inkonsistenten Benutzererfahrung führen.Being assigned to multiple conflicting flights can lead to an inconsistent user experience. Weist die zweite Anforderung beispielsweise eine andere Flight-Zuweisung als die erste auf, kann dies zu einer unerwarteten Benutzererfahrung führen.For example, if the second request has a different flight assignment than the first, the experience may be unexpected. Außerdem kann Bing die Client-ID zur Anpassung der Webergebnisse an den Suchverlauf dieser Client-ID verwenden. Dies führt zu einer noch besseren Benutzererfahrung.Also, Bing can use the client ID to tailor web results to that client ID’s search history, providing a richer experience for the user.

Bing verwendet den Header auch, um die Rangfolge der Ergebnisse zu verbessern, indem es die Aktivität der Client-ID analysiert.Bing also uses this header to help improve result rankings by analyzing the activity generated by a client ID. Durch die verbesserte Relevanz erhöht sich die Qualität der von Bing-APIs bereitgestellten Ergebnisse, was wiederum zu höheren Durchklickraten für den API-Consumer führt.The relevance improvements help with better quality of results delivered by Bing APIs and in turn enables higher click-through rates for the API consumer.

WICHTIG: Auch wenn er optional ist, sollten Sie diesen Header als erforderlich betrachten.IMPORTANT: Although optional, you should consider this header required. Das Beibehalten der Client-ID für dieselbe Kombination aus Benutzer und Gerät über mehrere Anforderungen hinweg ermöglicht 1) dem API-Consumer eine konsistente Benutzererfahrung sowie 2) höhere Durchklickraten durch eine bessere Qualität der Bing-API-Ergebnisse.Persisting the client ID across multiple requests for the same end user and device combination enables 1) the API consumer to receive a consistent user experience, and 2) higher click-through rates via better quality of results from the Bing APIs.

Die folgenden Grundregeln gelten bei der Verwendung dieses Headers.The following are the basic usage rules that apply to this header.
  • Jeder Benutzer, der die Anwendung auf dem Gerät verwendet, muss über eine eindeutige, von Bing generierte Client-ID verfügen.Each user that uses your application on the device must have a unique, Bing generated client ID.

    Wenn Sie diesen Header nicht in die Anforderung einfügen, generiert Bing eine ID, die im Antwortheader „X-MSEdge-ClientID“ zurückgegeben wird.If you do not include this header in the request, Bing generates an ID and returns it in the X-MSEdge-ClientID response header. Der einzige Zeitpunkt, zu dem dieser Header NICHT in eine Anforderung eingeschlossen werden sollte, ist bei der erstmaligen Verwendung der App auf dem Gerät.The only time that you should NOT include this header in a request is the first time the user uses your app on that device.

  • ACHTUNG: Vergewissern Sie sich, dass die Client-ID nicht mit authentifizierbaren Benutzerkontoinformationen verknüpft werden kann.ATTENTION: You must ensure that this Client ID is not linkable to any authenticatable user account information.

  • Verwenden Sie die Client-ID für jede Anforderung der Bing-API, die die App für diesen Benutzer auf dem Gerät durchführt.Use the client ID for each Bing API request that your app makes for this user on the device.

  • Behalten Sie die Client-ID bei.Persist the client ID. Verwenden Sie ein permanentes HTTP-Cookie, um sicherzustellen, dass die ID in einer Browser-App bei allen Sitzungen verwendet wird.To persist the ID in a browser app, use a persistent HTTP cookie to ensure the ID is used across all sessions. Verwenden Sie kein Sitzungscookie.Do not use a session cookie. Verwenden Sie für andere Apps wie z.B. mobile Apps den permanenten Speicher des Geräts, um die ID beizubehalten.For other apps such as mobile apps, use the device's persistent storage to persist the ID.

    Rufen Sie bei der nächsten Verwendung der App auf dem Gerät durch den Benutzer die gespeicherte Client-ID ab.The next time the user uses your app on that device, get the client ID that you persisted.

HINWEIS: Bing-Antworten können diesen Header enthalten, müssen es aber nicht.NOTE: Bing responses may or may not include this header. Enthält die Antwort diesen Header, erfassen Sie die Client-ID, und verwenden Sie sie für alle nachfolgenden Bing-Anforderungen des Benutzers auf diesem Gerät.If the response includes this header, capture the client ID and use it for all subsequent Bing requests for the user on that device.

ANMERKUNG Wenn Sie die X-MSEdge-ClientID einschließen, dürfen Sie keine Cookies in die Anforderung aufnehmen.NOTE If you include the X-MSEdge-ClientID, you must not include cookies in the request.
X-Search-ClientIPX-Search-ClientIP Optionaler Anforderungsheader.Optional request header.

Die IPv4- oder IPv6-Adresse des Clientgeräts.The IPv4 or IPv6 address of the client device. Die IP-Adresse wird verwendet, um den Standort des Benutzers zu ermitteln.The IP address is used to discover the user's location. Bing verwendet die Standortinformationen für ein sicheres Suchverhalten.Bing uses the location information to determine safe search behavior.

HINWEIS: Auch wenn dies optional ist, sollten Sie diesen Header und den Header „X-Search-Location“ immer angeben.NOTE: Although optional, you are encouraged to always specify this header and the X-Search-Location header.

Verschleiern Sie nicht die Adresse (z.B. durch Ändern des letzten Oktetts in 0).Do not obfuscate the address (for example, by changing the last octet to 0). Durch Verschleiern der Adresse stimmen Ihr Standort und der tatsächliche Gerätestandort nicht überein, wodurch Bing möglicherweise fehlerhafte Ergebnisse anzeigt.Obfuscating the address results in the location not being anywhere near the device's actual location, which may result in Bing serving erroneous results.
X-Search-LocationX-Search-Location Optionaler Anforderungsheader.Optional request header.

Eine durch Semikolons getrennte Liste mit Schlüssel/Wert-Paaren, die den geografischen Standort des Clients beschreiben.A semicolon-delimited list of key/value pairs that describe the client's geographical location. Bing verwendet die Standortinformationen für ein sicheres Suchverhalten und zur Rückgabe von lokalen relevanten Inhalten.Bing uses the location information to determine safe search behavior and to return relevant local content. Geben Sie das Schlüssel-Wert-Paar im Format <Schlüssel>:<Wert> an.Specify the key/value pair as <key>:<value>. Verwenden Sie die folgenden Schlüssel zur Angabe des Benutzerstandorts.The following are the keys that you use to specify the user's location.

  • lat (erforderlich):lat—Required. Der Breitengrad des Clientstandorts (in Grad).The latitude of the client's location, in degrees. Der Breitengrad muss größer als oder gleich -90,0 und kleiner als oder gleich +90,0 sein.The latitude must be greater than or equal to -90.0 and less than or equal to +90.0. Negative Werte geben südliche Breitengrade und positive Werte nördliche Breitengrade an.Negative values indicate southern latitudes and positive values indicate northern latitudes.

  • long (erforderlich):long—Required. Der Längengrad des Clientstandorts (in Grad).The longitude of the client's location, in degrees. Der Längengrad muss größer als oder gleich -180,0 und kleiner als oder gleich +180,0 sein.The longitude must be greater than or equal to -180.0 and less than or equal to +180.0. Negative Werte geben westliche Längengrade und positive Werte östliche Längengrade an.Negative values indicate western longitudes and positive values indicate eastern longitudes.

  • re (erforderlich):re—Required. Der Radius (in Metern), der die horizontale Genauigkeit der Koordinaten angibt.The radius, in meters, which specifies the horizontal accuracy of the coordinates. Übergeben Sie den Wert, der vom Standortdienst des Geräts zurückgegeben wird.Pass the value returned by the device's location service. Typische Werte sind 22 m für GPS/WLAN, 380 m für die Funkmasttriangulation und 18.000 m für die umgekehrte IP-Suche.Typical values might be 22m for GPS/Wi-Fi, 380m for cell tower triangulation, and 18,000m for reverse IP lookup.

  • ts (optional):ts—Optional. Der UTC-Unixzeitstempel des Zeitpunkts, zu dem sich der Client am Standort befand.The UTC UNIX timestamp of when the client was at the location. (Der UNIX-Zeitstempel gibt die Anzahl der Sekunden seit dem 1. Januar 1970 an.)(The UNIX timestamp is the number of seconds since January 1, 1970.)

  • head: Optional.head—Optional. Relatives Ziel oder Reiserichtung des Clients.The client's relative heading or direction of travel. Geben Sie die Reiserichtung von 0 bis 360 (in Grad) im Uhrzeigersinn ausgehend vom geografischen Norden an.Specify the direction of travel as degrees from 0 through 360, counting clockwise relative to true north. Geben Sie diesen Schlüssel nur an, wenn der sp-Schlüssel ungleich 0 ist.Specify this key only if the sp key is nonzero.

  • sp (optional):sp—Optional. Die horizontale Geschwindigkeit (in Metern pro Sekunde), mit der das Clientgerät unterwegs ist.The horizontal velocity (speed), in meters per second, that the client device is traveling.

  • alt (optional):alt—Optional. Die Höhe des Clientgeräts (in Metern).The altitude of the client device, in meters.

  • are: Optional.are—Optional. Der Radius (in Metern), der die vertikale Genauigkeit der Koordinaten angibt.The radius, in meters, that specifies the vertical accuracy of the coordinates. Geben Sie diesen Schlüssel nur an, wenn Sie auch den alt-Schlüssel angeben.Specify this key only if you specify the alt key.

  • disp—Optional.disp—Optional. Der geografische Standort des Benutzers im Formular disp:<City, State>.The user’s geographic location in the form, disp:<City, State>. Beispiel: disp:Seattle, Washington.For example, disp:Seattle, Washington. Dies ist die Anzeigetextversion des Standorts des Benutzers, die Sie mit den Lat/Long-Tasten angegeben haben.This is the display text version of the user’s location that you specified using the lat/long keys. Wenn dieser Wert mit den lat/long-Koordinaten in Konflikt steht, verwendet Bing den disp-Wert als Standort des Benutzers.If this value conflicts with the lat/long coordinates, Bing uses the disp value as the user's location.

HINWEIS: Bing ignoriert diesen Header, wenn die Abfrage einen Speicherort enthält.NOTE: Bing ignores this header if the query includes a location. Wenn dieser Header z. B. den Standort des Benutzers als San Francisco angibt, die Abfrage jedoch Restaurants seattleist, gibt Bing Restaurants in Seattle, Washington, zurück.For example, if this header reflects the user’s location as San Francisco, but the query is restaurants seattle, Bing returns restaurants located in Seattle, Washington.

HINWEIS: Auch wenn viele der Schlüssel optional sind, werden die Standortergebnisse immer genauer, je mehr Informationen Sie bereitstellen.NOTE: Although many of the keys are optional, the more information that you provide, the more accurate the location results are.

HINWEIS: Auch wenn dies optional ist, sollten Sie den geografischen Standort des Benutzers immer angeben.NOTE: Although optional, you are encouraged to always specify the user's geographical location. Besonders wichtig ist die Standortangabe dann, wenn die IP-Adresse des Clients den physischen Standort des Benutzers nicht exakt wiedergibt (wenn der Client beispielsweise VPN verwendet).Providing the location is especially important if the client's IP address does not accurately reflect the user's physical location (for example, if the client uses VPN). Für optimale Ergebnisse sollten Sie diesen Header und den X-Search-ClientIP-Header einschließen, aber mindestens diesen Header.For optimal results, you should include this header and the X-Search-ClientIP header, but at a minimum, you should include this header.

Hinweis

Beachten Sie, dass die Nutzungsbedingungen die Einhaltung aller geltenden Gesetze erfordert. Dies gilt auch für die Verwendung dieses Headers.Remember that the Terms of Use require compliance with all applicable laws, including regarding use of these headers. Die Rechtsprechung in bestimmten Ländern (z.B. in Europa) erfordert etwa die Zustimmung des Benutzers, um bestimmte Tracking-Geräte auf Benutzergeräten platzieren zu dürfen.For example, in certain jurisdictions, such as Europe, there are requirements to obtain user consent before placing certain tracking devices on user devices.

AbfrageparameterQuery parameters

Im Folgenden finden Sie die Liste der Abfrageparameter, die Sie angeben können.The following is the list of query parameters that you may specify. Die erforderlichen Parameter Finden Sie in der Spalte „Erforderlich“.See the Required column for required parameters. Die Abfrageparameterwerte müssen URL-codiert sein.The query parameter values must be URL encoded.

nameName WertValue typeType ErforderlichRequired
cccc Eine zweistellige Ländervorwahl des Landes, aus dem die Ergebnisse stammen.A two-character country code of the country where the results come from. Eine Liste möglicher Werte finden Sie unter Marktcodes.For a list of possible values, see Market Codes.

Wenn Sie diesen Parameter festlegen, müssen Sie auch den Header Accept-Language angeben.If you set this parameter, you must also specify the Accept-Language header. Bing verwendet die erste unterstützte Sprache, die es in den angegebenen Sprachen findet, und kombiniert sie mit dem Ländercode, um den Markt zu bestimmen, für den Ergebnisse zurückgegeben werden sollen.Bing uses the first supported language it finds in the specified languages and combines it with the country code to determine the market to return results for. Enthält die Liste der Sprachen keine unterstützte Sprache, sucht Bing die nächstgelegene Sprache und den nächstgelegenen Markt, die die Anforderung unterstützen.If the languages list does not include a supported language, Bing finds the closest language and market that supports the request. Oder Bing verwendet einen aggregierten oder Standardmarkt für die Ergebnisse.Or, Bing may use an aggregated or default market for the results.

Verwenden Sie diesen Accept-Language Abfrageparameter und den Header nur, wenn Sie mehrere Sprachen angeben.Use this query parameter and the Accept-Language header only if you specify multiple languages. Andernfalls sollten Sie mkt die setLang und Abfrageparameter verwenden.Otherwise, you should use the mkt and setLang query parameters.

Dieser Parameter und der Abfrageparameter mkt— schließen sich gegenseitig aus. Geben Sie daher nicht beide an.This parameter and the mkt query parameter are mutually exclusive—do not specify both.
StringString Nein No
countcount Die Anzahl von Suchergebnissen, die in der Antwort zurückgegeben werden sollen.The number of search results to return in the response. Der Standardwert ist 10, und der maximal angegebene Wert ist 50.The default is 10 and the maximum value that you may specify is 50. Die tatsächlich gelieferte Anzahl kann geringer sein als angefordert.The actual number delivered may be less than requested.

Verwenden Sie diesen offset Parameter zusammen mit dem Parameter zu Seitenergebnissen.Use this parameter along with the offset parameter to page results. Weitere Informationen finden Sie unter Paging-Webseiten.For more information, see Paging Webpages.

Wenn Ihre Benutzeroberfläche beispielsweise 10 Suchergebnisse pro Seite count enthält, offset werden Sie auf 10 und auf 0 gesetzt, um die erste Seite der Ergebnisse abzusehen.For example, if your user interface presents 10 search results per page, you would set count to 10 and offset to 0 to get the first page of results. Für jede nachfolgende Seite offset erhöhen Sie sich um 10 (z. B. 0, 10, 20).For each subsequent page, you would increment offset by 10 (for example, 0, 10, 20). Es ist möglich, dass mehrere Seiten einige Überlappungen in die Ergebnisse einbeziehen.It is possible for multiple pages to include some overlap in results.
UnsignedShortUnsignedShort Nein No
customConfigcustomConfig Eindeutiger Bezeichner, der Ihre benutzerdefinierte Suchinstanz identifiziert.Unique identifier that identifies your custom search instance.

StringString JaYes
mktmkt Der Markt, aus dem die Ergebnisse stammen.The market where the results come from. In mkt der Regel ist das Land, aus dem der Benutzer die Anforderung stellt.Typically, mkt is the country where the user is making the request from. Es kann jedoch ein anderes Land sein, wenn sich der Benutzer nicht in einem Land befindet, in dem Bing Ergebnisse liefert.However, it could be a different country if the user is not located in a country where Bing delivers results. Der Markt muss in <der>-<Form>Sprachcode-Ländercode sein.The market must be in the form <language code>-<country code>. Beispiel: en-US.For example, en-US. Bei der Zeichenfolge wird die Groß-/Kleinschreibung nicht berücksichtigt.The string is case insensitive. Eine Liste der möglichen Marktwerte finden Sie unter Marktcodes.For a list of possible market values, see Market Codes.

HINWEIS: Wenn bekannt, werden Sie aufgefordert, immer den Markt anzugeben.NOTE: If known, you are encouraged to always specify the market. Die Angabe des Marktes ermöglicht Bing, die Anforderung weiterzuleiten und eine geeignete und optimale Antwort zurückzugeben.Specifying the market helps Bing route the request and return an appropriate and optimal response. Wenn Sie einen Markt angeben, der nicht in Market Codesaufgeführt ist, verwendet Bing einen Marktcode, der auf einer internen Zuordnung basiert, die sich ändern kann.If you specify a market that is not listed in Market Codes, Bing uses a best fit market code based on an internal mapping that is subject to change.

Dieser Parameter und der Abfrageparameter cc— schließen sich gegenseitig aus. Geben Sie daher nicht beide an.This parameter and the cc query parameter are mutually exclusive—do not specify both.
StringString Nein No
offsetoffset Der nullbasierte Offset, der die Anzahl der zu überspringenden Suchergebnisse angibt, bevor die Ergebnisse zurückgegeben werden.The zero-based offset that indicates the number of search results to skip before returning results. Die Standardeinstellung ist 0.The default is 0. Der Offset sollte kleiner sein als (totalEstimatedMatches - count).The offset should be less than (totalEstimatedMatches - count).

Verwenden Sie diesen count Parameter zusammen mit dem Parameter zu Seitenergebnissen.Use this parameter along with the count parameter to page results. Wenn Ihre Benutzeroberfläche beispielsweise 10 Suchergebnisse pro Seite count enthält, offset werden Sie auf 10 und auf 0 gesetzt, um die erste Seite der Ergebnisse abzusehen.For example, if your user interface presents 10 search results per page, you would set count to 10 and offset to 0 to get the first page of results. Für jede nachfolgende Seite offset erhöhen Sie sich um 10 (z. B. 0, 10, 20).For each subsequent page, you would increment offset by 10 (for example, 0, 10, 20). Es ist möglich, dass mehrere Seiten einige Überlappungen in die Ergebnisse einbeziehen.It is possible for multiple pages to include some overlap in results.
Unsigned ShortUnsigned Short Nein No
qq Die Suchabfragezeichenfolge des Benutzers.The user's search query string. Die Abfragezeichenfolge darf nicht leer sein.The query string must not be empty.

HINWEIS: Die Abfragezeichenfolge darf keine erweiterten Bing-Operatorenenthalten.NOTE: The query string must not contain Bing Advanced Operators. Einschließlich sie kann sich negativ auf die benutzerdefinierte Sucherfahrung auswirken.Including them may adversely affect the custom search experience.
StringString JaYes
safeSearchsafeSearch Ein Filter, der Webseiten nach jugendgefährdenden Inhalten durchsucht.A filter used to filter webpages for adult content. Im Folgenden sind die möglichen Filterwerte zu finden.The following are the possible filter values.
  • Off: Es werden Webseiten mit nicht jugendfreiem Text oder Bildern zurückgegeben.Off—Return webpages with adult text, images, or videos.

  • Moderate: Webseiten mit nicht jugendfreiem Text werden zurückgegeben, nicht jugendfreie Bilder oder Videos jedoch nicht.Moderate—Return webpages with adult text, but not adult images or videos.

  • Strict: Es werden keine Webseiten mit nicht jugendfreiem Text bzw. nicht jugendfreien Bildern oder Videos zurückgegeben.Strict—Do not return webpages with adult text, images, or videos.

Die Standardeinstellung ist „Moderate“.The default is Moderate.

HINWEIS: Stammt die Anforderung aus einem Markt, für den laut Bing-Richtlinien zu nicht jugendfreien Inhalten für safeSearch die Einstellung „Strict“ erforderlich ist, ignoriert Bing den safeSearch-Wert und verwendet stattdessen „Strict“.NOTE: If the request comes from a market that Bing's adult policy requires that safeSearch is set to Strict, Bing ignores the safeSearch value and uses Strict.

StringString Nein No
setLangsetLang Die Sprache, die für Zeichenfolgen der Benutzeroberfläche verwendet werden soll.The language to use for user interface strings. Sie können die Sprache entweder mit einem 2-Buchstaben- oder einem 4-Buchstaben-Code angeben.You may specify the language using either a 2-letter or 4-letter code. Die Verwendung von 4-Buchstaben-Codes wird bevorzugt.Using 4-letter codes is preferred.

Eine Liste der unterstützten Sprachcodes finden Sie unter Bing-unterstützte Sprachen.For a list of supported language codes, see Bing supported languages.

Bing lädt die lokalisierten Zeichenfolgen, wenn setlang sie einen gültigen neutralen Kulturcode mit 2 Buchstaben (fr) oder einen gültigen 4-Buchstaben-spezifischen Kulturcode (fr-ca) enthalten.Bing loads the localized strings if setlang contains a valid 2-letter neutral culture code (fr) or a valid 4-letter specific culture code (fr-ca). Beispielsweise lädt Bing für fr-cadie fr neutralen Kulturcodezeichenfolgen.For example, for fr-ca, Bing loads the fr neutral culture code strings.

Wenn setlang nicht gültig ist (z. B. zh) oder Bing unterstützt die Sprache nicht (z. B. af, af-na), Bing standardmäßig auf en (Englisch).If setlang is not valid (for example, zh) or Bing doesn’t support the language (for example, af, af-na), Bing defaults to en (English).

Um den 2-Buchstaben-Code anzugeben, legen Sie diesen Parameter auf einen ISO 639-1-Sprachcode fest.To specify the 2-letter code, set this parameter to an ISO 639-1 language code.

Um den 4-Buchstaben-Code anzugeben, verwenden Sie das Formular -<Land/Region> wobei es sich um einen ISO 639-1-Sprachcode (neutrale Kultur) handelt und <Land/Region> ein ISO 3166-Länder-/Regionscode (spezifische Kultur) ist.To specify the 4-letter code, use the form -<country/region> where is an ISO 639-1 language code (neutral culture) and <country/region> is an ISO 3166 country/region (specific culture) code. Verwenden Sie z. B. en-US für US-Englisch.For example, use en-US for United States English.

Auch wenn dies optional ist, sollten Sie immer eine Sprache angeben.Although optional, you should always specify the language. In der Regel wird bei setLang dieselbe Sprache angegeben wie bei mkt, sofern der Benutzer die Zeichenfolgen der Benutzeroberfläche nicht in einer anderen Sprache anzeigen möchte.Typically, you set setLang to the same language specified by mkt unless the user wants the user interface strings displayed in a different language.

Dieser Parameter und der Accept-Language-Header schließen sich gegenseitig aus – geben Sie nicht beides an.This parameter and the Accept-Language header are mutually exclusive—do not specify both.

Eine Zeichenfolge der Benutzeroberfläche ist eine Zeichenfolge, die als Bezeichnung in einer Benutzeroberfläche verwendet wird.A user interface string is a string that's used as a label in a user interface. Die JSON-Antwortobjekte enthalten nur wenige Zeichenfolgen für Benutzeroberflächen.There are few user interface strings in the JSON response objects. Die angegebene Sprache wird auch in Links zu Eigenschaften von „bing.com“ in den Antwortobjekten verwendet.Also, any links to Bing.com properties in the response objects apply the specified language.
StringString Nein No
TextdecorationstextDecorations Ein boolescher Wert, der bestimmt, ob Anzeigezeichenfolgen Dekorationsmarkierungen wie Trefferhervorhebungszeichen enthalten sollen.A Boolean value that determines whether display strings should contain decoration markers such as hit highlighting characters. Wenn true, können die Zeichenfolgen Marker enthalten. andernfalls false.If true, the strings may include markers; otherwise, false. Der Standardwert ist false.The default is false.

Informationen dazu, ob Unicode-Zeichen oder HTML-Tags als Marker verwendet werden sollen, finden Sie im Parameter textFormat-Abfrage.To specify whether to use Unicode characters or HTML tags as the markers, see the textFormat query parameter.

Informationen zur Trefferhervorhebung finden Sie unter Hit-Hervorhebung.For information about hit highlighting, see Hit Highlighting.
BooleanBoolean Nein No
textFormattextFormat Der Typ der Marker, die für Textdekorationen verwendet werden sollen (siehe textDecorations Abfrageparameter).The type of markers to use for text decorations (see the textDecorations query parameter).

Folgende Werte sind möglich:The following are the possible values.
  • Raw—Verwenden Sie Unicode-Zeichen, um Inhalte zu markieren, die eine spezielle Formatierung benötigen.Raw—Use Unicode characters to mark content that needs special formatting. Die Unicode-Zeichen liegen im Bereich E000 bis E019.The Unicode characters are in the range E000 through E019. Bing verwendet z. B. E000 und E001, um den Anfang und das Ende von Abfragebegriffen für die Trefferhervorhebung zu markieren.For example, Bing uses E000 and E001 to mark the beginning and end of query terms for hit highlighting.

  • HTML—Verwenden Sie HTML-Tags, um Inhalte zu markieren, die eine spezielle Formatierung benötigen.HTML—Use HTML tags to mark content that needs special formatting. Verwenden Sie <beispielsweise b> Tags, um Abfragebegriffe in Anzeigezeichenfolgen hervorzuheben.For example, use <b> tags to highlight query terms in display strings.

Der Standardwert ist Raw.The default is Raw.

Eine Liste der Marker finden Sie unter Hit-Hervorhebung.For a list of markers, see Hit Highlighting.

Wenn textFormat auf HTML festgelegt ist und Anzeigezeichenfolgen nicht fähige HTML-Zeichen wie <, > und < & &enthalten, escapet Bing die Zeichen (z. B. wird ein Escapeplatz nach lt;).If textFormat is set to HTML, and display strings contain escapable HTML characters such as <, >, and &, Bing escapes the characters (for example, < is escaped to &lt;).

Informationen zum Verarbeiten von Zeichenfolgen mit den eingebetteten Unicode-Zeichen finden Sie unter Hit-Hervorhebung.For information about processing strings with the embedded Unicode characters, see Hit Highlighting.
StringString Nein No

AntwortobjekteResponse objects

Hinweis

Um der neuen EU-Urheberrechtsrichtlinie in Frankreich zu entsprechen, müssen die Bing-Web-, Nachrichten-, Video-, Bild- und alle Benutzer-Such-APIs einige Inhalte aus bestimmten EU-Nachrichtenquellen für französische Nutzer weglassen.To comply with the new EU Copyright Directive in France, the Bing Web, News, Video, Image and all Custom Search APIs must omit some content from certain EU News sources for French users. Der entfernte Inhalt kann Miniaturbilder und -videos, Videovorschauen und Ausschnitte enthalten, die Suchergebnisse aus diesen Quellen begleiten.The removed content may include thumbnail images and videos, video previews, and snippets which accompany search results from these sources. Daher können die Bing-APIs französischen Benutzern mit Miniaturbildern und -videos, Videovorschauen und Ausschnitten weniger Ergebnisse liefern.As a consequence, the Bing APIs may serve fewer results with thumbnail images and videos, video previews, and snippets to French users.

Im Folgenden finden Sie die JSON-Antwortobjekte, die die Antwort enthalten können.The following are the JSON response objects that the response may include. Wenn die Anforderung erfolgreich ist, ist das Objekt der obersten Ebene in der Antwort das SearchResponse-Objekt. Andernfalls ist es das ErrorResponse-Objekt.If the request is successful, the top-level object in the response is the SearchResponse object; otherwise, it is the ErrorResponse object.

ObjectObject BeschreibungDescription
FehlerError Definiert einen aufgetretenen Fehler.Defines an error that occurred.
ErrorResponseErrorResponse Das Objekt auf oberster Ebene, das die Antwort enthält, wenn die Anforderung fehlschlägt.The top-level object that the response includes when the request fails.
MetatagMetaTag Definiert die Metadaten einer Webseite.Defines a webpage's metadata.
OpenGraphImageOpenGraphImage Definiert die Position und die Abmessungen eines Bildes, die für eine Webseite relevant sind.Defines the location and dimensions of an image relevant to a webpage.
AbfrageQuery Definiert eine Abfragezeichenfolge.Defines a query string.
QuerycontextQueryContext Definiert den Abfragekontext, den Bing für die Anforderung verwendet hat, wenn die angegebene Abfragezeichenfolge einen Rechtschreibfehler enthält.Defines the query context that Bing used for the request, if the specified query string contains a spelling error.
SearchResponseSearchResponse Das Objekt der obersten Ebene, das die Antwort enthält, wenn die Anforderung erfolgreich ausgeführt wird.The top-level object that the response includes when the request succeeds.
WebAnswerWebAnswer Definiert eine Liste relevanter Webseitenlinks.Defines a list of relevant webpage links.
WebseiteWebpage Definiert eine Webseite, die für die Abfrage relevant ist.Defines a webpage that is relevant to the query.

FehlerError

Definiert einen aufgetretenen Fehler.Defines an error that occurred.

ElementElement BeschreibungDescription typeType
codecode Der Fehlercode, der den Fehler identifiziert.The error code that identifies the error. Eine Liste der möglichen Codes finden Sie unter Fehlercodes.For a list of possible codes, see Error Codes. StringString
messagemessage Eine Beschreibung des Fehlers.A description of the error. StringString
parameterparameter Der Abfrageparameter in der Anforderung, der den Fehler verursacht hat.The query parameter in the request that caused the error. StringString
valuevalue Der Wert des Abfrageparameters, der ungültig war.The query parameter's value that was not valid. StringString

ErrorResponseErrorResponse

Das Objekt auf oberster Ebene, das die Antwort enthält, wenn die Anforderung fehlschlägt.The top-level object that the response includes when the request fails.

nameName WertValue typeType
_type_type Der Typhinweis.Type hint. StringString
errorserrors Eine Liste der Gründe für den Fehler der Anforderung.A list of the reasons why the request failed. Fehler[]Error[]

MetatagMetaTag

Definiert die Metadaten einer Webseite.Defines a webpage's metadata.

nameName WertValue typeType
Inhaltcontent Die Metadaten.The metadata. StringString
namename Der Name der Metadaten.The name of the metadata. StringString

OpenGraphImageOpenGraphImage

Definiert die Position und die Abmessungen eines Bildes, die für eine Webseite relevant sind.Defines the location and dimensions of an image relevant to a webpage.

nameName WertValue typeType
contentUrlcontentUrl Der Speicherort des Bildes.The image's location. StringString
widthwidth Die Breite des Bilds.The width of the image. Kann Null (0) sein.May be zero (0). UInt32UInt32
heightheight Die Höhe des Bilds.The height of the image. Kann Null (0) sein.May be zero (0). UInt32UInt32

AbfrageQuery

Definiert eine Suchabfrage.Defines a search query.

nameName WertValue typeType
displayTextdisplayText Die Anzeigeversion der Abfragezeichenfolge.The display version of the query string. Diese Version der Abfragezeichenfolge kann Sonderzeichen enthalten, die den in der Abfragezeichenfolge gefundenen Suchbegriff hervorheben.This version of the query string may contain special characters that highlight the search term found in the query string. Die Zeichenfolge enthält die Hervorhebungszeichen nur, wenn die Abfrage die Hervorhebung aktiviert hat (siehe den Abfrageparameter textDecorations).The string contains the highlighting characters only if the query enabled hit highlighting (see the textDecorations query parameter). Weitere Informationen zur Trefferhervorhebung finden Sie unter Hit-Hervorhebung.For details about hit highlighting, see Hit Highlighting. StringString
Texttext Die Abfragezeichenfolge.The query string. Verwenden Sie diese Zeichenfolge als Abfragezeichenfolge in einer neuen Suchanforderung.Use this string as the query string in a new search request. StringString

QueryContextQueryContext

Definiert die Abfragezeichenfolge, die Bing für die Anforderung verwendet hat, wenn die angegebene Abfragezeichenfolge einen Rechtschreibfehler enthält.Defines the query string that Bing used for the request if the specified query string contains a spelling mistake.

ElementElement BeschreibungDescription typeType
adultIntentadultIntent Ein boolescher Wert, der angibt, ob die angegebene Abfrage nicht jugendfreie Inhalte aufweist.A Boolean value that indicates whether the specified query has adult intent. Der Wert ist true, wenn die Abfrage eine Erwachsenenabsicht hat.The value is true if the query has adult intent.

Wenn trueund der SafeSearch-Abfrageparameter der Anforderung auf Strict festgelegt ist, enthält die Antwort keine Ergebnisse.If true, and the request's safeSearch query parameter is set to Strict, the response will not contain results.
BooleanBoolean
alterationOverrideQueryalterationOverrideQuery Die zu verwendende Abfragezeichenfolge, um Bing zu zwingen, die ursprüngliche Zeichenfolge zu verwenden.The query string to use to force Bing to use the original string. Wenn die Abfragezeichenfolge z. B. downwind saling, lautet die Überschreibungsabfragezeichenfolge +saling downwind.For example, if the query string is saling downwind, the override query string is +saling downwind. Denken Sie daran, die Abfragezeichenfolge zu codieren, was zu %2Bsaling+downwindführt.Remember to encode the query string, which results in %2Bsaling+downwind.

Das Objekt enthält dieses Feld nur, wenn die ursprüngliche Abfragezeichenfolge einen Rechtschreibfehler enthält.The object includes this field only if the original query string contains a spelling mistake.
StringString
alteredQueryalteredQuery Die Abfragezeichenfolge, die von Bing verwendet wird, um die Abfrage auszuführen.The query string used by Bing to perform the query. Wenn die ursprüngliche Abfragezeichenfolge Rechtschreibfehler enthält, verwendet Bing die geänderte Abfragezeichenfolge.If the original query string contained spelling mistakes, Bing uses the altered query string. Wenn die Abfragezeichenfolge z. B. saling downwindlautet sailing downwind, ist die geänderte Abfragezeichenfolge .For example, if the query string is saling downwind, the altered query string is sailing downwind.

Das Objekt enthält dieses Feld nur, wenn die ursprüngliche Abfragezeichenfolge einen Rechtschreibfehler enthält.The object includes this field only if the original query string contains a spelling mistake.
StringString
originalQueryoriginalQuery Die Abfragezeichenfolge wie in der Anforderung angegeben.The query string as specified in the request. StringString

SearchResponseSearchResponse

Das Objekt der obersten Ebene der Antwort für Suchanforderungen.The response's top-level object for search requests.

Wenn der Dienst einen Denial-of-Service-Angriff vermutet, ist die Anforderung erfolgreich (HTTP-Statuscode: 200 OK). Der Antworttext ist jedoch leer.If the service suspects a denial of service attack, the request succeeds (HTTP status code is 200 OK); however, the body of the response is empty.

nameName WertValue typeType
_type_type Der Typhinweis, der auf SearchResponse festgelegt wird.Type hint, which is set to SearchResponse. StringString
queryContextqueryContext Die Abfragezeichenfolge, die Bing für die Anforderung verwendet hat.The query string that Bing used for the request.

Die Antwort enthält den Kontext nur, wenn die Abfragezeichenfolge einen Rechtschreibfehler enthält oder eine Absicht für Erwachsene hat.The response includes the context only if the query string contains a spelling mistake or has adult intent.
QuerycontextQueryContext
WebseitenwebPages Eine Liste der Webseiten, die für die Suchabfrage relevant sind.A list of webpages that are relevant to the search query. WebAnswerWebAnswer

WebAnswerWebAnswer

Definiert eine Liste relevanter Webseitenlinks.Defines a list of relevant webpage links.

nameName WertValue typeType
totalEstimatedMatchestotalEstimatedMatches Die geschätzte Anzahl von Webseiten, die für die Abfrage relevant sind.The estimated number of webpages that are relevant to the query. Verwenden Sie diese Zahl zusammen mit den Zähl- und Offsetabfrageparametern, um die Ergebnisse zu durchblättern. offsetUse this number along with the count and offset query parameters to page through the results. Weitere Informationen finden Sie unter Paging-Ergebnisse.For information, see Paging Results. LongLong
valuevalue Eine Liste der Webseiten, die für die Abfrage relevant sind.A list of webpages that are relevant to the query. Webseite[]WebPage[]
webSearchUrlwebSearchUrl Die URL zur Bing-Website, die die Suchergebnisse für die Abfrage des Benutzers enthält.The URL to the Bing website that contains the search results for the user's query. Die Ergebnisse umfassen Inhalte, die nicht auf Ihre benutzerdefinierte Ansicht des Webs beschränkt sind, und können andere Arten von Inhalten wie Bilder und Videos enthalten.The results include content that is not limited to your custom view of the web, and may include other types of content such as images and videos. StringString

WebseiteWebpage

Definiert eine Webseite, die für die Abfrage relevant ist.Defines a webpage that is relevant to the query.

nameName WertValue typeType
dateLastCrawleddateLastCrawled Das letzte Mal, dass Bing die Webseite durchforstet hat.The last time that Bing crawled the webpage. Das Datum ist in der Form, YYYY-MM-DDTHH:MM:SS.The date is in the form, YYYY-MM-DDTHH:MM:SS. Beispiel: 2015-04-13T05:23:39.For example, 2015-04-13T05:23:39. StringString
DeeplinksdeepLinks Ein Array von Webseitenobjekten.An array of Webpage objects. Jedes Objekt enthält einen Link zu verwandten Inhalten innerhalb der Website, die diese Webseite enthält.Each object contains a link to related content within the website that contains this webpage.

Das Webpage Objekt in diesem nameKontext urlenthält snippet nur die Felder , und.The Webpage object in this context includes only the name, url, and snippet fields.
Webseite[]Webpage[]
displayUrldisplayUrl Die Anzeige-URL der Webseite.The display URL of the webpage. Die URL ist nur für Anzeigezwecke gedacht und nicht gut formatiert.The URL is meant for display purposes only and is not well formed. StringString
idid Ein Bezeichner.An identifier. StringString
Namenname Der Name der Webseite.The name of the webpage.

Verwenden Sie diesen url Namen zusammen mit, um einen Hyperlink zu erstellen, der den Benutzer beim Klicken zur Webseite führt.Use this name along with url to create a hyperlink that when clicked takes the user to the webpage.

Der Name kann Sonderzeichen enthalten, die den im Namen gefundenen Suchbegriff hervorheben.The name may contain special characters that highlight the search term found in the name. Der Name enthält die Hervorhebungszeichen nur, wenn die Abfrage die Trefferhervorhebung aktiviert hat (siehe den Abfrageparameter textDecorations).The name contains the highlighting characters only if the query enabled hit highlighting (see the textDecorations query parameter). Weitere Informationen zur Trefferhervorhebung finden Sie unter Hit-Hervorhebung.For details about hit highlighting, see Hit Highlighting.
StringString
searchTagssearchTags Eine Liste der Suchtags, die der Webseitenbesitzer auf der Webseite angegeben hat.A list of search tags that the webpage owner specified on the webpage. Die API gibt nur indizierte Suchtags zurück.The API returns only indexed search tags.

Das name Feld MetaTag des Objekts enthält das indizierte Suchtag.The name field of the MetaTag object contains the indexed search tag. Suchtags beginnen mit search.* (z. B. search.assetId).Search tags begin with search.* (for example, search.assetId). Das content Feld enthält den Wert des Tags.The content field contains the tag's value.
MetaTag[]MetaTag[]
Codeausschnittsnippet Ein Textausschnitt von der Webseite, der den Inhalt beschreibt.A snippet of text from the webpage that describes its contents. StringString
Urlurl Die URL zur Webseite.The URL to the webpage.

Verwenden Sie diese name URL zusammen mit, um einen Hyperlink zu erstellen, der den Benutzer beim Klicken zur Webseite führt.Use this URL along with name to create a hyperlink that when clicked takes the user to the webpage.
StringString
openGraphImageopenGraphImage URL für ein Bild, das der Seitenbesitzer für die Darstellung des Seiteninhalts ausgewählt hat.URL for an image that the page owner chose to represent the page content.

Nur enthalten, wenn verfügbar.Included only if available.
OpenGraphImageOpenGraphImage

FehlercodesError codes

Im Folgenden finden Sie die möglichen HTTP-Statuscodes, die eine Anforderung zurückgeben kann.The following are the possible HTTP status codes that a request returns.

StatuscodeStatus Code BeschreibungDescription
200200 Erfolg.Success.
400400 Einer der Abfrageparameter fehlt oder ist ungültig.One of the query parameters is missing or not valid.
401401 Der Abonnementschlüssel fehlt oder ist ungültig.The subscription key is missing or is not valid.
403403 Der Benutzer ist authentifiziert (er hat z.B. einen gültigen Abonnementschlüssel verwendet), aber er ist nicht für die angeforderte Ressource berechtigt.The user is authenticated (for example, they used a valid subscription key) but they don’t have permission to the requested resource.

Bing gibt diesen Status möglicherweise auch zurück, wenn der Aufrufer sein Kontingent für Abfragen pro Monat überschritten hat.Bing may also return this status if the caller exceeded their queries per month quota.
410410 Die Anforderung hat HTTP anstelle des HTTPS-Protokolls verwendet.The request used HTTP instead of the HTTPS protocol. HTTPS ist das einzige unterstützte Protokoll.HTTPS is the only supported protocol.
429429 Der Aufrufer hat sein Kontingent für Abfragen pro Sekunde überschritten.The caller exceeded their queries per second quota.
500500 Unerwarteter Serverfehler.Unexpected server error.

Wenn die Anforderung fehlschlägt, enthält die Antwort ein ErrorResponse-Objekt, das eine Liste der Fehler-Objekte enthält, die beschreiben, was den Fehler verursacht hat.If the request fails, the response contains an ErrorResponse object, which contains a list of Error objects that describe what caused of error. Wenn sich der Fehler auf einen Parameter bezieht, identifiziert das parameter-Feld den Parameter, der das Problem darstellt.If the error is related to a parameter, the parameter field identifies the parameter that is the issue. Wenn sich der Fehler auf einen Parameterwert bezieht, identifiziert das value-Feld den Wert, der ungültig ist.And if the error is related to a parameter value, the value field identifies the value that is not valid.

{
  "_type": "ErrorResponse", 
  "errors": [
    {
      "code": "InvalidRequest", 
      "subCode": "ParameterMissing", 
      "message": "Required parameter is missing.", 
      "parameter": "q" 
    }
  ]
}

{
  "_type": "ErrorResponse", 
  "errors": [
    {
      "code": "InvalidAuthorization", 
      "subCode": "AuthorizationMissing", 
      "message": "Authorization is required.", 
      "moreDetails": "Subscription key is not recognized."
    }
  ]
}

Die folgenden Werte sind für den Fehlercode und Unterfehlercodes möglich.The following are the possible error code and sub-error code values.

CodeCode SubCodeSubCode BeschreibungDescription
ServerErrorServerError UnexpectedErrorUnexpectedError
ResourceErrorResourceError
NotImplementedNotImplemented
Der HTTP-Statuscode ist 500.HTTP status code is 500.
InvalidRequestInvalidRequest ParameterMissingParameterMissing
ParameterInvalidValueParameterInvalidValue
HttpNotAllowedHttpNotAllowed
BlockiertBlocked
Bing gibt InvalidRequest zurück, wenn ein beliebiger Teil der Anforderung ungültig ist.Bing returns InvalidRequest whenever any part of the request is not valid. Beispielsweise, wenn ein erforderlicher Parameter fehlt oder ein Parameterwert ungültig ist.For example, a required parameter is missing or a parameter value is not valid.

Wenn der Fehler ParameterMissing oder ParameterInvalidValue ist, lautet der HTTP-Statuscode 400.If the error is ParameterMissing or ParameterInvalidValue, the HTTP status code is 400.

Wenn Sie das HTTP-Protokoll anstelle von HTTPS verwenden, gibt Bing HttpNotAllowed zurück, und der HTTP-Statuscode ist 410.If you use the HTTP protocol instead of HTTPS, Bing returns HttpNotAllowed, and the HTTP status code is 410.
RateLimitExceededRateLimitExceeded Keine UntercodesNo sub-codes Bing gibt RateLimitExceeded zurück, wenn Sie Ihr Kontingent für Abfragen pro Sekunde (Queries Per Second, QPS) oder Abfragen pro Monat (Queries Per Month, QPM) überschreiten.Bing returns RateLimitExceeded whenever you exceed your queries per second (QPS) or queries per month (QPM) quota.

Wenn Sie QPS überschreiten, gibt Bing den HTTP-Statuscode 429 zurück. Wenn Sie QPM überschreiten, wird 403 von Bing zurückgegeben.If you exceed QPS, Bing returns HTTP status code 429, and if you exceed QPM, Bing returns 403.
InvalidAuthorizationInvalidAuthorization AuthorizationMissingAuthorizationMissing
AuthorizationRedundancyAuthorizationRedundancy
Bing gibt InvalidAuthorization zurück, wenn Bing den Aufrufer nicht authentifizieren kann.Bing returns InvalidAuthorization when Bing cannot authenticate the caller. Beispielsweise, wenn der Ocp-Apim-Subscription-Key-Header fehlt oder der Abonnementschlüssel ungültig ist.For example, the Ocp-Apim-Subscription-Key header is missing or the subscription key is not valid.

Redundanz tritt auf, wenn Sie mehrere Authentifizierungsmethoden angeben.Redundancy occurs if you specify more than one authentication method.

Wenn der Fehler InvalidAuthorization ist, lautet der HTTP-Statuscode 401.If the error is InvalidAuthorization, the HTTP status code is 401.
InsufficientAuthorizationInsufficientAuthorization AuthorizationDisabledAuthorizationDisabled
AuthorizationExpiredAuthorizationExpired
Wenn der Aufrufer nicht über Berechtigungen für den Zugriff auf die Ressource verfügt, gibt Bing InsufficientAuthorization zurück.Bing returns InsufficientAuthorization when the caller does not have permissions to access the resource. Dies kann der Fall sein, wenn der Abonnementschlüssel deaktiviert wurde oder abgelaufen ist.This can occur if the subscription key has been disabled or has expired.

Wenn der Fehler InsufficientAuthorization ist, lautet der HTTP-Statuscode 403.If the error is InsufficientAuthorization, the HTTP status code is 403.

MarktcodesMarket codes

In der folgenden Tabelle sind die Marktcodewerte mkt aufgeführt, die Sie zum Angeben des Abfrageparameters verwenden können.The following table lists the market code values that you may use to specify the mkt query parameter. Bing gibt nur Inhalt für diese Märkte zurück.Bing returns content for only these markets. Änderungen der Liste vorbehalten.The list is subject to change.

Eine Liste der Ländercodes, die cc Sie im Abfrageparameter angeben können, finden Sie unter Ländercodes.For a list of country codes that you may specify in the cc query parameter, see Country codes.

Land/RegionCountry/Region SpracheLanguage MarktcodeMarket code
ArgentinienArgentina SpanischSpanish es-ARes-AR
AustralienAustralia EnglischEnglish en-AUen-AU
ÖsterreichAustria DeutschGerman de-ATde-AT
BelgienBelgium NiederländischDutch nl-BEnl-BE
BelgienBelgium FranzösischFrench fr-BEfr-BE
BrasilienBrazil PortugiesischPortuguese pt-BRpt-BR
CanadaCanada EnglischEnglish en-CAen-CA
CanadaCanada FranzösischFrench fr-CAfr-CA
ChileChile SpanischSpanish es-CLes-CL
DänemarkDenmark DänischDanish da-DKda-DK
FinnlandFinland FinnischFinnish fi-FIfi-FI
FrankreichFrance FranzösischFrench fr-FRfr-FR
DeutschlandGermany DeutschGerman de-DEde-DE
Hongkong (SAR)Hong Kong SAR Chinesisch (traditionell)Traditional Chinese zh-HKzh-HK
IndienIndia EnglischEnglish en-INen-IN
IndonesienIndonesia EnglischEnglish en-IDen-ID
ItalienItaly ItalienischItalian it-ITit-IT
JapanJapan JapanischJapanese ja-JPja-JP
KoreaKorea KoreanischKorean ko-KRko-KR
MalaysiaMalaysia EnglischEnglish en-MYen-MY
MexikoMexico SpanischSpanish es-MXes-MX
NiederlandeNetherlands NiederländischDutch nl-NLnl-NL
NeuseelandNew Zealand EnglischEnglish en-NZen-NZ
NorwegenNorway NorwegischNorwegian no-NOno-NO
VR ChinaPeople's republic of China ChinesischChinese zh-CNzh-CN
PolenPoland PolnischPolish pl-PLpl-PL
Republik PhilippinenRepublic of the Philippines EnglischEnglish en-PHen-PH
RusslandRussia RussischRussian ru-RUru-RU
SüdafrikaSouth Africa EnglischEnglish en-ZAen-ZA
SpanienSpain SpanischSpanish es-ESes-ES
SchwedenSweden SchwedischSwedish sv-SEsv-SE
SchweizSwitzerland FranzösischFrench fr-CHfr-CH
SchweizSwitzerland DeutschGerman de-CHde-CH
TaiwanTaiwan Chinesisch (traditionell)Traditional Chinese zh-TWzh-TW
TürkeiTurkey TürkischTurkish tr-TRtr-TR
United KingdomUnited Kingdom EnglischEnglish en-GBen-GB
USAUnited States EnglischEnglish de-DEen-US
USAUnited States SpanischSpanish es-USes-US

LandeskennzahlenCountry codes

Die folgenden Landeskennzahlen können Sie im cc-Abfrageparameter angeben.The following are the country codes that you may specify in the cc query parameter. Änderungen der Liste vorbehalten.The list is subject to change.

Land/RegionCountry/Region LandesvorwahlCountry Code
ArgentinienArgentina ARAR
AustralienAustralia AUAU
ÖsterreichAustria ATAT
BelgienBelgium BEBE
BrasilienBrazil BRBR
CanadaCanada CACA
ChileChile CLCL
DänemarkDenmark DKDK
FinnlandFinland FIFI
FrankreichFrance BVFR
DeutschlandGermany DEDE
Hongkong (SAR)Hong Kong SAR HKHK
IndienIndia ININ
IndonesienIndonesia idID
ItalienItaly ITIT
JapanJapan JPJP
KoreaKorea KRKR
MalaysiaMalaysia MYMY
MexikoMexico MXMX
NiederlandeNetherlands NLNL
NeuseelandNew Zealand NZNZ
NorwegenNorway NeinNO
VR ChinaPeople's Republic of China CNCN
PolenPoland PLPL
PortugalPortugal PTPT
Republik PhilippinenRepublic of the Philippines PHPH
RusslandRussia RURU
Saudi-ArabienSaudi Arabia SASA
SüdafrikaSouth Africa ZAZA
SpanienSpain ESES
SchwedenSweden SESE
SchweizSwitzerland CHCH
TaiwanTaiwan TWTW
TürkeiTurkey TRTR
United KingdomUnited Kingdom GBGB
USAUnited States USUS

Bing-unterstützte SprachenBing supported languages

Im Folgenden finden Sie die von Bing setLang unterstützten Sprachen, die Sie im Abfrageparameter angeben können.The following are the Bing supported languages that you may specify in the setLang query parameter. Änderungen der Liste vorbehalten.The list is subject to change.

Unterstützte SprachenSupported Languages SprachcodeLanguage Code
ArabischArabic arar
BaskischBasque eueu
BengaliBengali bnbn
BulgarischBulgarian bgbg
KatalanischCatalan caca
Chinesisch (vereinfacht)Chinese (Simplified) zh-hanszh-hans
Chinesisch (traditionell)Chinese (Traditional) zh-hantzh-hant
KroatischCroatian hrhr
TschechischCzech cscs
DänischDanish dada
NiederländischDutch nlnl
EnglischEnglish enen
Englisch-Vereinigtes KönigreichEnglish-United Kingdom en-gben-gb
EstnischEstonian etet
FinnischFinnish fifi
FranzösischFrench frfr
GalizischGalician glgl
DeutschGerman dede
GujaratiGujarati gugu
HebräischHebrew hehe
HindiHindi hihi
UngarischHungarian huhu
IsländischIcelandic isis
ItalienischItalian itit
JapanischJapanese Jpjp
KannadaKannada knkn
KoreanischKorean koko
LettischLatvian lvlv
LitauischLithuanian ltlt
MalaiischMalay msms
MalayalamMalayalam  mlml
MarathiMarathi mrmr
Norwegisch (Bokmål)Norwegian (Bokmål) nbnb
PolnischPolish plpl
Portugiesisch (Brasilien)Portuguese (Brazil) pt-brpt-br
Portugiesisch (Portugal)Portuguese (Portugal) pt-ptpt-pt
PandschabiPunjabi papa
RumänischRomanian roro
RussischRussian ruru
Serbisch (Cyrylic)Serbian (Cyrylic) srsr
SlowakischSlovak sksk
SlowenischSlovenian slsl
SpanischSpanish eses
SchwedischSwedish svsv
TamilischTamil tata
TeluguTelugu tete
ThailändischThai thth
TürkischTurkish trtr
UkrainischUkrainian ukuk
VietnamesischVietnamese vivi