Webbsökning referens för API-v7

Varning

API:er för Bing-sökresultat flyttas från Cognitive Services till Bing-sökning tjänster. Från och med den 30 oktober 2020 måste alla nya instanser av Bing-sökning tillhandahållas enligt processen som dokumenteras här. API:er för Bing-sökresultat som har tillhandahållits med hjälp av Cognitive Services kommer att stödjas under de kommande tre åren eller tills Enterprise-avtals slut, beroende på vilket som sker först. Instruktioner för migrering finns i Bing-sökning Services.

Med Webbsökning-API: et kan du skicka en Sök fråga till Bing och få tillbaka Sök resultat som innehåller länkar till webb sidor, bilder med mera. Det här avsnittet innehåller teknisk information om webb sidor, relaterade sökningar och ranknings resultat utöver de frågeparametrar som påverkar Sök resultaten. Exempel som visar hur du gör förfrågningar finns i söka på webben.

Information om rubriker som begär Anden ska inkludera finns i begärandehuvuden.

Information om frågeparametrar som begär Anden ska inkludera finns i frågeparametrar.

Information om de JSON-objekt som svaret kan innehålla finns i svars texten. Den här referensen innehåller JSON-objekt som är särskilt för webb svar. Mer information om JSON-objekt för andra svars typer som Sök resultaten kan innehålla finns i API-Specific Reference Documentation. Om Sök resultatet till exempel innehåller bilder och diskussions svar kan du läsa bildsökning API och NYHETSSÖKNING- API.

Information om tillåten användning och visning av resultat finns i Bing-sökning API-användning och visnings krav.

Anteckning

Eftersom URL-format och parametrar kan ändras utan föregående meddelande, använder du alla URL: er som de är. Du bör inte ta beroenden i URL-formatet eller parametrar förutom där det anges.

Slutpunkter

Om du vill begära webb Sök Resultat skickar du en GET-begäran till:

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

För prenumerationer med flera tjänster måste du inkludera regionen i URL: en. Till exempel: westus.api.cognitive.microsoft.com. Se regioner som stöds.

Begäran måste använda HTTPS-protokollet.

Anteckning

Den maximala URL-längden är 2 048 tecken. För att se till att URL-längden inte överskrider gränsen ska den maximala längden för dina frågeparametrar innehålla färre än 1 500 tecken. Om URL: en överskrider 2 048 tecken returnerar servern 404 som inte hittas.

Sidhuvuden

Följande är huvuden som en begäran och ett svar kan innehålla.

Sidhuvud Beskrivning
Acceptera Valfritt begärandehuvud.

Standard medie typen är Application/JSON. Om du vill ange att svaret använder JSON-LD, ställer du in accept-huvudet på Application/LD + JSON.
Accept-Language Valfritt begärandehuvud.

En kommaavgränsad lista över språk som ska användas för användargränssnittssträngar. Listan är i fallande prioritetsordning. Mer information, bland annat om det förväntade formatet, finns i RFC2616.

Det är huvudet och setLang-frågeparametern utesluter varandra—ange inte båda två.

Om du anger huvudet måste du även ange frågeparametern cc. För att fastställa vilken marknad som resultat ska returneras för använder Bing det första språk som stöds på listan och kombinerar det med parametervärdet cc. Om listan inte innehåller något språk som stöds hittar Bing det närmaste språket och marknaden som har stöd för begäran, eller så använder Bing en aggregerad eller standardmarknad för resultatet. För att avgöra vilken marknad som används i Bing kan du gå till BingAPIs-Market-huvudet.

Använd enbart det här huvudet och cc-frågeparametern om du anger flera språk. Annars kan du använda frågeparametrarna mkt och setLang.

En användargränssnittssträng är en sträng som används som en etikett i ett användargränssnitt. Det finns några användargränssnittssträngar i JSON-svarsobjekt. Alla länkar till Bing.com-egenskaper i svarsobjekten använder det angivna språket.
BingAPIs-Market Svarshuvud.

Marknaden som används av begäran. Formuläret är <languageCode> - <countryCode> . Exempel: sv-SE.

Om du anger en marknad som inte finns med på marknads koderkan det här värdet skilja sig från marknaden som du angav i mkt -Frågeparametern. Detsamma gäller om du anger värden för CC och Accept-language som inte kan synkroniseras.
BingAPIs-TraceId Svarshuvud.

ID för loggposten som innehåller information om begäran. När ett fel uppstår ska du avbilda detta ID. Om det inte går att fastställa och lösa problemet ska du ange ID:t tillsammans med annan information som du ger supportteamet.
Ocp-Apim-Subscription-Key Begärandehuvud som krävs.

Prenumerationsnyckeln som du fick när du registrerade dig för den här tjänsten i Cognitive Services.
Pragma Valfritt begärandehuvud

Som standard returnerar Bing cachelagrat innehåll om det finns. Om du vill förhindra att Bing returnerar cachelagrat innehåll ska du ställa in huvudet Pragma på no-cache (till exempel Pragma: no-cache).
Försök igen Svarshuvud.

Svaret innehåller den här rubriken om du överskrider antalet frågor som tillåts per sekund (frågor per sekund) eller per månad (QPM). Rubriken innehåller antalet sekunder som du måste vänta innan du skickar en annan begäran.
User-Agent Valfritt begärandehuvud.

Användaragenten som skapade begäran. Bing använder användaragenten för att ge mobila användare en optimerad upplevelse. Även om det är valfritt rekommenderar vi även att du alltid anger det här huvudet.

Användaragenten ska vara samma sträng som alla vanliga webbläsare skickar. Information om användaragenter finns i RFC 2616.

Här följer några exempel på användaragentsträngar.
  • Windows Phone—Mozilla/5.0 (kompatibel; 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; som Gecko) Version/4.0 Mobile Safari/533.1

  • iPhone—Mozilla/5.0 (iPhone; CPU iPhone OS 6_1 som Mac OS X) AppleWebKit/536.26 (KHTML; som 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) som Gecko

  • iPad—Mozilla/5.0 (iPad; CPU OS 7_0 som Mac OS X) AppleWebKit/537.51.1 (KHTML, som Gecko) Version/7.0 Mobile/11A465 Safari/9537.53
X-MSEdge-ClientID Valfritt huvud för begäran och svar.

Bing använder det här huvudet för att ge användarna konsekvent beteende i Bing API-anrop. Bing ger ofta förhandsversioner av nya funktioner och förbättringar och använder klient-ID som en nyckel för att tilldela trafik till olika förhandsversioner. Om du inte använder samma klient-ID för en användare vid flera förfrågningar kan sedan Bing tilldela användaren flera motstridiga förhandsversioner. Om du tilldelas flera motstridiga förhandsversioner kan det leda till en inkonsekvent användarupplevelse. Om till exempel den andra begäran har en annan förhandsversionstilldelning än den första kan upplevelsen vara oväntad. Bing kan också använda klient-ID: t för att skräddarsy webb resultat till klient-ID: t för Sök historiken, vilket ger en rikare upplevelse för användaren.

Bing använder också det här huvudet för att förbättra resultatets rangordning genom att analysera aktiviteten som genererats av ett klient-ID. Relevansförbättringarna kan ge bättre resultat som levereras av Bing-API: er, vilka i sin tur möjliggör högre klickfrekvens för API-konsumenten.

Viktigt! Även om det är valfritt bör du överväga att använda det här huvudet som krävs. Bestående klient-ID för flera förfrågningar för samma slutanvändare och enhetskombination gör det möjligt 1) för API-konsumenten att få en konsekvent användarupplevelse och 2) att få högre klickfrekvens via resultat av högre kvalitet från Bing-API: er.

Följande är de grundläggande användningsregler som gäller för det här huvudet.
  • Varje användare som använder ditt program på enheten måste ha ett unikt, Bing-genererat klient-ID.

    Om du inte använder det här huvudet i begäran genererar Bing ett ID och returnerar det i svarshuvudet X-MSEdge-ClientID. Den enda gången som du inte får inkludera det här huvudet i en begäran är första gången du använder din app på enheten.

  • Obs! Du måste se till att detta klient-ID inte är länkbart till någon autentiserad användarkontoinformation.

  • Använd klient-ID för varje Bing API-begäran som din app gör för den här användaren på enheten.

  • Spara klient-ID:t. Om du vill bevara ID:t i en webbläsarapp ska du använda en beständig HTTP-cookie i alla sessioner. Använd inte en sessionscookie. För andra appar, till exempel mobilappar, använder du enhetens beständiga lagring för att bevara ID.

    Nästa gång användaren använder appen på enheten ska du hämta klient-ID:t som du sparade.

Obs! Bing-svar kanske eller kanske inte omfattar det här huvudet. Om svaret innehåller det här huvudet ska du avbilda klient-ID:t och använda det för alla efterföljande Bing-begäranden för användaren på enheten.

Obs! Om du inkluderar X-MSEdge-ClientID får du inte ta med cookies i begäran.
X-MSEdge-ClientIP Valfritt begärandehuvud.

Klientenhetens IPv4- eller IPv6-adress. IP-adressen används för att identifiera användarens plats. Bing använder platsinformationen för att fastställa SafeSearch-beteende.

Obs! Även om det är valfritt rekommenderar vi att du alltid anger det här huvudet och huvudet X-Search-Location.

Förvräng inte adressen (till exempel genom att ändra den sista oktetten till 0). Om adressresultatet förvillas på en plats som inte är i närheten av enhetens verkliga plats kan det leda till att Bing presenterar felaktiga resultat.
X-Search-Location Valfritt begärandehuvud.

En semikolonavgränsad lista med nyckel/värde-par som beskriver klientens geografiska plats. Bing använder platsinformationen till att fastställa ett säkert sökbeteende och returnera relevant lokalt innehåll. Ange nyckel/värde-paret som <key> : <value> . Följande är de nycklar som används för att ange användarens plats.

  • lat—krävs. Latitud för klientens plats i grader. Latituden måste vara större än eller lika med -90.0 och vara mindre än eller lika med +90.0. Negativa värden anger sydliga latituder och positiva värden anger nordliga latituder.

  • long—Required. Longitud för klientens plats i grader. Longituden måste vara större än eller lika med -180.0 och vara mindre än eller lika med +180.0. Negativa värden anger västliga longituder och positiva värden anger östliga longituder.

  • re—Krävs. Radien, i meter, som anger koordinaternas vågräta exakthet. Skicka värdet som returneras av enhetens platstjänst. Typiska värden kan vara 22 m för GPS/Wi-Fi, 380 m för mobiltornstriangulering och 18 000 m för omvänd IP-sökning.

  • ts—Valfritt. UTC-UNIX-tidsstämpel för när klienten befann sig på platsen. (UNIX-tidsstämpeln är antalet sekunder sedan den 1 januari 1970.)

  • head—Optional. Klientens relativa riktning eller färdriktning. Ange färdriktningen som grader från 0 till 360 där du räknar medurs i förhållande till norr. Ange endast den här nyckeln om nyckeln sp är nollskiljd.

  • sp—Optional. Den vågräta hastigheten i meter per sekund som klientenheten färdas.

  • alt—Valfritt. Klientenhetens höjd i meter.

  • are—Valfritt. Radien, i meter, som anger koordinaternas lodräta exakthet. Ange den här nyckeln endast om du anger nyckeln alt.

  • DISP — valfri. Användarens geografiska plats i formuläret, DISP: <ort, delstats>. Till exempel, DISP: Seattle, Washington. Detta är visnings text versionen av användarens plats som du angav med hjälp av Lat/Long-nycklarna. Om det här värdet är i konflikt med Lat/Long-koordinaterna använder Bing värdet DISP som användarens plats.

Obs: Bing ignorerar den här rubriken om frågan innehåller en plats. Exempel: om rubriken visar användarens plats som San Francisco, men frågan är restaurang Seattle , returnerar Bing restauranger som finns i Seattle, Washington.

Obs! Även om många av nycklarna är valfria blir resultatet för platsen mer exakt ju mer information du anger.

Obs! Även om det är valfritt rekommenderar vi att du alltid anger användarens geografiska plats. Det är särskilt viktigt att ange plats om klientens IP-adress inte exakt avspeglar användarens fysiska plats (till exempel om klienten använder VPN). För bästa resultat bör du ta med rubriken och huvudet X-search-ClientIP, men du bör minst ta med den här rubriken.

Anteckning

Kom ihåg att användningsvillkoren kräver efterlevnad med alla tillämpliga lagar, inklusive lagar om användande av dessa huvud. I till exempel vissa jurisdiktioner, som Europa, finns det krav på att skaffa användarens medgivande innan du placerar vissa spårningsenheter på användarenheter.

Frågeparametrar

Följande frågeparametrar är de frågeparametrar som begäran kan innehålla. Kolumnen Obligatorisk anger om du måste ange parametern. Du måste URL-koda frågeparameterns värden.

Name Värde Typ Obligatorisk
answerCount Antalet svar som du vill att svaret ska innehålla. Svaren som Bing returnerar baseras på rangordning. Om Bing till exempel returnerar webb sidor, bilder, videor och relatedSearches för en begäran och du anger den här parametern till två (2), innehåller svaret webb sidor och avbildningar.

Om du har inkluderat responseFilter frågeparametern i samma begäran och ställt in den på webb sidor och diskussions grupper innehåller svaret endast webb sidor.

Information om hur du höjer ett Rankat svar i svaret finns i avsnittet befordra.
Osignerat heltal No
cc En landskod som består av två tecken för det land där resultatet kommer från. En lista över möjliga värden finns i marknads koder.

Om du anger parametern måste du även ange huvudet Accept-Language. Bing använder det första språket som stöds i de angivna språken och kombinerar det med lands koden för att fastställa på vilken marknad marknaden ska returnera resultat. Om listan över språk inte innehåller något språk som stöds hittar Bing det närmaste språket och marknaden som har stöd för begäran. Eller så kan Bing använda en aggregerad eller standard marknad för resultaten.

Använd bara den här Frågeparametern och Accept-Language rubriken om du anger flera språk. Annars bör du använda mkt setLang parametrarna och.

Den här parametern och mkt-frågeparametern utesluter varandra—ange inte båda två.
Sträng No
reparationer Det antal Sök resultat som ska returneras i svaret. Standardvärdet är 10 och det maximala värdet är 50. Det faktiska antalet som levereras kan vara mindre än begärt.

Använd den här parametern tillsammans med offset parametern till sid resultat. Mer information finns i sid indelning av webb sidor.

Om ditt användar gränssnitt till exempel visar 10 Sök Resultat per sida, anger count du till 10 och offset 0 för att få den första resultat sidan. Öka med 10 för varje efterföljande sida offset (till exempel 0, 10, 20). Det är möjligt att flera sidor innehåller vissa överlappande resultat.
Egenskapsvärdet No
färskhet Filtrera Sök Resultat efter följande Skift läges okänsliga ålders värden:
  • Dag — RETUR webb sidor som Bing identifierade under de senaste 24 timmarna

  • Vecko Visa — RETUR webb sidor som Bing identifierade under de senaste 7 dagarna

  • Månads — RETUR webb sidor som identifierats under de senaste 30 dagarna

Om du vill hämta artiklar som identifierats av Bing under en specifik tids period anger du ett datum intervall i formatet ÅÅÅÅ-MM-DD.. ÅÅÅÅ-MM-DD. Till exempel &freshness=2019-02-01..2019-05-30. Om du vill begränsa resultatet till ett enda datum anger du den här parametern till ett visst datum. Till exempel &freshness=2019-02-04.
Sträng No
mkt Marknaden som resultatet kommer från. Normalt mkt är det land där användaren gör begäran från. Det kan dock vara ett annat land om användaren inte finns i ett land där Bing ger resultat. Marknaden måste vara i formatet <language code> - <country code> . Exempel: sv-SE. Strängen är Skift läges okänslig. En lista över möjliga marknads värden finns i marknads koder.

Obs: Om det är känt rekommenderar vi att du alltid anger marknaden. Om du anger marknaden gör det enklare för Bing att dirigera begäran och returnera ett lämpligt och optimalt svar. Om du anger en marknad som inte finns med på marknads koder, använder Bing en bäst anpassad marknads kod baserat på en intern mappning som kan komma att ändras.

Den här parametern och cc-frågeparametern utesluter varandra—ange inte båda två.
Sträng No
redovisningsmotkonto Den nollbaserade förskjutningen som anger antalet Sök resultat som ska hoppas över innan resultatet returneras. Standardvärdet är 0. Förskjutningen måste vara mindre än (totalEstimatedMatches - count ).

Använd den här parametern tillsammans med count parametern till sid resultat. Om ditt användar gränssnitt till exempel visar 10 Sök Resultat per sida, anger count du till 10 och offset 0 för att få den första resultat sidan. Öka med 10 för varje efterföljande sida offset (till exempel 0, 10, 20). Det är möjligt att flera sidor innehåller vissa överlappande resultat.
Osignerad kort No
marknadsföra En kommaavgränsad lista med svar som du vill att svaret ska innehålla oavsett rangordning. Om du till exempel anger answerCount) till två (2) så returnerar Bing de två främsta rankade svaren, men du vill även att svaret ska innehålla nyheter promote . Om de mest rankade svaren är webb sidor, bilder, videor och relatedSearches, innehåller svaret webb sidor och bilder eftersom nyheterna inte är ett Rankat svar. Men om du anger promote till video befordrar Bing Video svaret till svaret och returnerar webb sidor, bilder och videor.

Svaren som du vill befordra räknas inte mot answerCount gränsen. Om till exempel de rankade svaren är nyheter, bilder och videor och du anger answerCount till 1 och promote till nyheter, innehåller svaret nyheter och bilder. Eller, om de rankade svaren är videor, bilder och nyheter, innehåller svaret videor och nyheter.

Följande är möjliga värden.
  • Vetenskap
  • Avbildningar
  • Nyheter
  • RelatedSearches
  • SpellSuggestions
  • TimeZone
  • Videoklipp
  • Webb sidor

Obs: Använd endast om du anger answerCount.
Sträng No
c Användarens villkor för Sök fråga. Termen får inte vara tom.

Termen kan innehålla avancerade Bing-operatorer. Om du till exempel vill begränsa resultaten till en speciell domän använder du operatorn plats: .
Sträng Yes
responseFilter En kommaavgränsad lista med svar som ska inkluderas i svaret. Om du inte anger den här parametern innehåller svaret alla Sök svar för vilka det finns relevanta data.

Följande är möjliga filter värden.
  • Vetenskap
  • Entiteter
  • Avbildningar
  • Nyheter
  • RelatedSearches
  • SpellSuggestions
  • TimeZone
  • Videoklipp
  • Webb sidor

Om du vill undanta vissa typer av innehåll, till exempel bilder, från svaret kan du undanta dem med prefixet bindestreck (minus) till responseFilter-värdet. Separera undantags typer med kommatecken: &responseFilter =-images,-videor

Även om du kan använda det här filtret för att få ett enda svar bör du i stället använda den svars bara slut punkten för att få bättre resultat. Om du till exempel bara vill ta emot bilder skickar du begäran till någon av bildsökning API -slutpunkterna.

Svars RelatedSearches och SpellSuggestions har inte stöd för en separat slut punkt som Bildsöknings-API: t (endast Webbsökning-API: et returnerar dem).

Om du vill inkludera svar som annars skulle uteslutas på grund av rangordning, se avsnittet befordra frågeparameter.
Sträng No
safeSearch filtrerar webb sidor för innehåll som är vuxna. Följande är möjliga filter värden.
  • Inaktivera — RETUR webb sidor med vuxen text och bilder.
  • Måttliga — RETUR webb sidor med vuxen text, men inte vuxna bilder eller videor.
  • Strict — returnerar inte webb sidor med vuxen text, bilder eller videor.
Standardinställningen är Måttlig.

Obs: För video resultat, om safeSearch är inställt på av, ignorerar Bing den och använder måttlig.

Obs: Om begäran kommer från en marknad som Bing: s vuxen princip kräver att safeSearch är inställd på Strict, ignorerar Bing safeSearch värdet och använder strikt.

Obs! Beroende på om du använder frågeoperator site: finns det en risk att svaret har innehåll som är olämpligt för barn oberoende av vad frågeparametern safeSearch är inställd på. Använd endast site: om du är medveten om innehållet på webbplatsen och ditt scenario tillåter möjligheten att det förekommer innehåll som är olämpligt för barn.
Sträng No
setLang Språket som ska användas för användargränssnittssträngar. Du kan ange språket genom att använda antingen en kod på 2 eller 4 bokstäver. Att använda 4-bokstavs koder rekommenderas.

En lista över språk koder som stöds finns i Bing-språk som stöds.

Bing läser in de lokaliserade strängarna om de setlang innehåller en giltig, neutral kultur kod ( fr ) med 2 tecken (FR) eller en giltig 4-Letter-speciell kultur kod ( fr-ca ). För t. ex. fr-ca laddar Bing de fr neutrala kultur kod strängarna.

Om setlang inte är giltigt (till exempel zh ) eller Bing stöder inte språket (t. ex. AF , af-na ), Bing som standard en (engelska).

Ange den här parametern till en ISO 639-1-språkkod om du vill ange koden för 2 tecken.

Om du vill ange koden för fyra bokstäver använder du <land/region> där är ISO 639-1-språkkoden (neutral kultur) och <land/region> är en ISO 3166 lands-/regions kod (specifik kultur). Använd exempelvis en-US för USA engelska.

Även om det är valfritt bör du alltid ange språket. Normalt anger du setLang på samma språk som anges av mkt om inte användaren vill att gränssnittets strängar ska visas på ett annat språk.

Den här parametern och Accept-Language rubriken är ömsesidigt uteslutande – ange inte båda.

En användargränssnittssträng är en sträng som används som en etikett i ett användargränssnitt. Det finns några användargränssnittssträngar i JSON-svarsobjekt. Alla länkar till Bing.com-egenskaper i svarsobjekten använder det angivna språket.
Sträng No
textDecorations Ett booleskt värde som avgör om visnings strängar ska innehålla dekorations markörer som träff markerings tecken. Om värdet är true kan strängarna innehålla markörer. Standardvärdet är false .

Om du vill ange om Unicode-tecken eller HTML-taggar ska användas som markörer, se Frågeparametern text formal .

Information om träff markering finns i träff markering.
Boolesk No
Form Typ av markörer som används för textdekorationer (se textDecorations Frågeparametern).

Följande är möjliga värden.
  • RAW — använder Unicode-tecken för att markera innehåll som behöver speciell formatering. Unicode-tecknen ligger inom intervallet E000 till E019. Bing använder exempelvis E000 och E001 för att markera början och slutet av sökorden för träff markering.

  • HTML — använder HTML-taggar för att markera innehåll som behöver speciell formatering. Använd exempelvis <b> taggar för att markera sökord i visnings strängar.

Standardvärdet är RAW.

En lista med markörer finns i träff markering.

För visnings strängar som innehåller undantags bara HTML-tecken, till exempel <, > och &, om textFormat är inställt på HTML, avvisar Bing tecknen efter behov (till exempel < är avbrotts enligt & lt;).

Information om hur du bearbetar strängar med inbäddade Unicode-tecken finns i träff markering.
Sträng No

Svars objekt

Anteckning

För att följa det nya EU: s Copyright-direktiv i Frankrike måste Bing-webben, nyheter, video, bild och alla anpassade Sök-API: er utelämna innehåll från vissa nyhets källor för EU för franska användare. Det borttagna innehållet kan innehålla miniatyr bilder och videor, video förhandsare och kodfragment som medföljer Sök Resultat från dessa källor. Som en följd kan Bing-API: er betjäna färre resultat med miniatyr bilder och videor, video förhands visning och kodfragment till franska användare.

Följande är de JSON-svars objekt som svaret kan innehålla. Om begäran lyckas, är objektet på den översta nivån i svaret SearchResponse -objektet. Om begäran Miss lyckas är objektet på den översta nivån ErrorResponse -objektet.

Den här listan innehåller JSON-objekt som är speciella för webb svar. Mer information om JSON-objekt för andra svars typer som Sök resultaten kan innehålla finns i API-Specific Reference Documentation. Om Sök resultatet t. ex. innehåller bilder och diskussions svar kan du läsa API för avbildning och diskussions grupp.

Objekt Beskrivning
Vetenskap Definierar ett uttryck och dess svar.
Entitet Definierar en entitet, till exempel person, plats eller sak.
Fel Definierar ett fel som har inträffat.
ErrorResponse Objektet på den översta nivån som svaret innehåller när begäran Miss lyckas.
Särskilj Definierar ett resurs-ID.
LicenseAttribution Definierar en avtals regel för licens behörighet.
LinkAttribution Definierar en avtals regel för länk behörighet.
MediaAttribution Definierar en avtals regel för medie behörighet.
Query Definierar en frågesträng.
QueryContext Definierar det frågeuttryck som Bing används för begäran, om den angivna frågesträngen innehåller ett stavfel.
RankingGroup Definierar en Sök Resultat grupp, till exempel Mainline.
RankingItem Definierar ett rangordnings grupp objekt att visa.
RankingResponse Definierar var på sidan med Sök Resultat sidans innehåll ska placeras och i vilken ordning.
RelatedSearchAnswer Definierar en lista över relaterade frågor som andra har gjort.
SearchResponse Objektet på den översta nivån som svaret innehåller när begäran lyckas.
SpellSuggestions Definierar en föreslagen frågesträng som troligt vis representerar användarens avsikt.
TextAttribution Definierar en avtals regel för oformaterad text-behörighet.
Informationen Definierar datum och tid för en eller flera geografiska platser.
TimeZoneInformation Definierar tids zons informationen om en geografisk plats.
Websvar Definierar en lista över relevanta länkar för webb sidor.
Historik Definierar en webb sida som är relevant för frågan.

Entitet

Definierar en entitet, till exempel person, plats eller sak.

Namn Värde Typ
bingId Ett ID som unikt identifierar den här entiteten. Sträng
contractualRules En lista med regler som du måste följa om du visar entiteten. Reglerna kan till exempel styra hur entitetens beskrivning ska beskrivas.

Följande avtals regler kan gälla.


Alla entiteter innehåller inte regler. Om entiteten innehåller avtals regler måste du följa dem. Mer information om hur du använder avtals regler finns i avsnittet data tilldelning.
Objekt []
beskrivning En kort beskrivning av entiteten. Sträng
entityPresentationInfo Ytterligare information om entiteten, till exempel tips som du kan använda för att fastställa enhetens typ. Använd fälten och för att fastställa enhetens typ entityScenario entityTypeHint . Fälten hjälper till exempel dig att avgöra om entiteten är en dominerande eller avtvetydighets enhet och om det är en person eller en film. Entiteten är en dominerande enhet om Bing anser att endast en entitet uppfyller begäran. Om flera entiteter kan uppfylla begäran är entiteten en distvetydighets-entitet och användaren måste välja den entitet som de är intresserade av. EntityPresentationInfo
image En bild av entiteten. Avbildning
name Entitetens namn. Sträng
webSearchUrl Den URL som tar användaren till Bing search-resultat sidan för den här entiteten. Sträng

EntityAnswer

Definierar ett enhets svar.

Namn Värde Typ
queryScenario Det scenario som stöds. Det här fältet är inställt på DominantEntity eller DisambiguationItem. Fältet är inställt på DominantEntity om Bing bestämmer att endast en enskild entitet uppfyller begäran. Till exempel en bok, film, person eller attraktionsvärdet. Om flera entiteter kan uppfylla begäran anges fältet till DisambiguationItem. Om begäran till exempel använder en generisk rubrik för en film-franchise-fråga skulle entitetens typ sannolikt vara DisambiguationItem. Men om begäran anger en speciell titel från franchisen skulle entitetens typ sannolikt vara DominantEntity. Sträng
värde En lista med entiteter. Entitet []

EntityPresentationInfo

Definierar ytterligare information om en entitet, till exempel typ tips.

Namn Värde Typ
entityScenario Det scenario som stöds. Sträng
entityTypeDisplayHint En visnings version av Entity-tipset. Om är till exempel entityTypeHints artist, kan det här fältet anges till American Singer . Sträng
entityTypeHint En lista med tips som visar entitetens typ. Listan kan innehålla en enda ledtråd, till exempel film eller en lista med tips som plats, LocalBusiness, restaurang. Varje efterföljande tips i matrisen begränsar entitetens typ.

En lista över möjliga typer finns i enhets typer. Om objektet inte innehåller det här fältet antas generiskt.
Sträng []

Vetenskap

Definierar ett uttryck och dess svar.

Element Beskrivning Typ
uttryck Uttrycket matematik eller omvandling.

Om frågan innehåller en begäran om att konvertera mått enheter (till exempel mätare till fötter), innehåller det här fältet från enheter och value innehåller till -enheter.

Om frågan innehåller ett matematiskt uttryck, till exempel 2 + 2, innehåller det här fältet uttrycket och value innehåller svaret.

Observera att matematiska uttryck kan normaliseras. Om frågan t. ex. rot (4 ^ 2 + 8 ^ 2), kan det normaliserade uttrycket vara sqrt ((4 ^ 2) + (8 ^ 2)).

Om användarens fråga är en matematisk fråga och parametern textDecorations har angetts till True kan uttrycks strängen innehålla formateringsmarkeringar. Om användarens fråga t. ex. är log (2) , innehåller det normaliserade uttrycket de nedsänkta markeringarna. Mer information finns i träff markering.
Sträng
värde Uttryckets svar. Sträng

Fel

Definierar det fel som inträffat.

Element Beskrivning Typ
rikt Felkoden som identifierar fel kategorin. En lista över möjliga koder finns i felkoder. Sträng
meddelande En beskrivning av felet. Sträng
moreDetails En beskrivning som ger ytterligare information om felet. Sträng
ProfileServiceApplicationProxy Frågeparametern i den begäran som orsakade felet. Sträng
under kod Felkoden som identifierar felet. Om till exempel code är InvalidRequest, subCode kan vara ParameterInvalid eller ParameterInvalidValue. Sträng
värde Värdet för frågeparametern är inte giltigt. Sträng

ErrorResponse

Objektet på den översta nivån som svaret innehåller när begäran Miss lyckas.

Namn Värde Typ
_type Typ tips. Sträng
kompileringsfel En lista med fel som beskriver orsakerna till att begäran misslyckades. Fel[]

Särskilj

Definierar identiteten för en resurs.

Namn Värde Typ
id En identifierare. Sträng

Bild

Definierar en bild.

Anteckning

Eftersom URL-formatet och parametrarna kan ändras utan föregående meddelande, ska alla bild-URL: er användas som de är. Du bör inte ta beroenden i URL-format eller parametrar. Undantaget är de parametrar och värden som diskuteras genom att ändra storlek och beskära miniatyr bilder.

Namn Värde Typ
mankhöjd Käll bildens höjd, i bild punkter. Osignerad kort
hostPageUrl Webb adressen till webb sidan som innehåller bilden.

Denna URL och contentUrl kan vara samma URL.
Sträng
name En valfri text sträng som innehåller slumpmässig information om avbildningen. Sträng
CSP Bildens källa. Matrisen kommer att innehålla ett enda objekt.

Du måste attribut avbildningen till providern. Du kan till exempel Visa Providerns namn när markören hovrar över bilden eller göra bilden till en klicknings länk till leverantörens webbplats där avbildningen finns.
Organisation[]
thumbnailUrl URL-adressen till en miniatyr bild av bilden. Information om hur du ändrar storlek på bilden finns i ändra storlek och beskär miniatyr bilder. Sträng
bredd Käll bildens bredd, i bild punkter. Osignerad kort

LicenseAttribution

Definierar en avtals regel för licens behörighet.

Namn Värde Typ
_type Ett typ tips, som är inställt på LicenseAttribution. Sträng
licens Den licens enligt vilken innehållet kan användas. Licens
licenseNotice Den licens som ska visas bredvid fältet mål. Till exempel "text under CC-BY-SA-licens".

Använd licensens namn och URL i license fältet för att skapa en hyperlänk till webbplatsen som beskriver licensens information. Ersätt sedan licens namnet i licenseNotice strängen (till exempel CC-by-sa) med den hyperlänk som du nyss skapade.
Sträng
mustBeCloseToContent Ett booleskt värde som anger om regelns innehåll måste placeras i närheten av det fält som regeln gäller för. Om det här värdet är sant måste innehållet placeras i nära närhet. Om det är falskt , eller om fältet inte finns, kan innehållet placeras på den som ringer upp. Boolesk
targetPropertyName Namnet på det fält som regeln gäller för. Sträng

LinkAttribution

Definierar en avtals regel för länk behörighet.

Namn Värde Typ
_type Ett typ tips, som är inställt på LinkAttribution. Sträng
mustBeCloseToContent Ett booleskt värde som anger om regelns innehåll måste placeras i närheten av det fält som regeln gäller för. Om det här värdet är sant måste innehållet placeras i nära närhet. Om det är falskt , eller om fältet inte finns, kan innehållet placeras på den som ringer upp. Boolesk
targetPropertyName Namnet på det fält som regeln gäller för.

Om ett mål inte anges, gäller behörigheten för entiteten som helhet och visas omedelbart efter Entity-presentationen. Om det finns flera text-och länk behörighets regler som inte anger ett mål, ska du sammanfoga dem och visa dem med hjälp av etiketten "data från:". Till exempel "data från <Provider name1 > | <Provider name2 > ".
Sträng
text Behörighets texten. Sträng
url URL: en till leverantörens webbplats. Använd text och URL för att skapa hyperlänk. Sträng

MediaAttribution

Definierar en avtals regel för medie behörighet.

Namn Värde Typ
_type Ett typ tips, som är inställt på MediaAttribution. Sträng
mustBeCloseToContent Ett booleskt värde som anger om regelns innehåll måste placeras i närheten av det fält som regeln gäller för. Om det här värdet är sant måste innehållet placeras i nära närhet. Om det är falskt , eller om fältet inte finns, kan innehållet placeras på den som ringer upp. Boolesk
targetPropertyName Namnet på det fält som regeln gäller för. Sträng
url Den URL som du använder för att skapa hyperlänken för medie innehållet. Om målet till exempel är en bild, använder du URL: en för att göra det möjligt att klicka på bilden. Sträng

Beskrivning

Definierar metadata för en webb sida.

Namn Värde Typ
innehåll Metadata. Sträng
name Namnet på metadatan. Sträng

Organisation

Definierar en utgivare.

Observera att en utgivare kan ange sitt namn eller deras webbplats eller både och.

Namn Värde Typ
name Utgivarens namn. Sträng
url URL: en till utgivarens webbplats.

Observera att utgivaren inte kan tillhandahålla en webbplats.
Sträng

Söka i data

Definierar en Sök fråga.

Objektet SpellSuggestions använder det här objektet för att föreslå en frågesträng som troligen representerar användarens avsikt. Den används också av RelatedSearchAnswer för att returnera en relaterad fråga som andra användare har gjort.

Namn Värde Typ
Visnings Visnings versionen av frågeterm. Den här versionen av frågeterm får innehålla specialtecken som markerar Sök termen som finns i frågesträngen. Strängen innehåller markerings tecken endast om frågan har aktiverat träff markering (se textDecorations -Frågeparametern). Mer information om träff markering finns i träff markering. Sträng
information Frågesträngen. Använd strängen som frågeterm i en ny Sök förfrågan. Sträng
webSearchUrl Den URL som tar användaren till Bing Searchs resultat sida för frågan.

Endast relaterade Sök Resultat innehåller det här fältet.
Sträng

QueryContext

Definierar frågesträngen som Bing används för begäran.

Element Beskrivning Typ
adultIntent Ett booleskt värde som anger om den angivna frågan har vuxen avsikt. Värdet är True om frågan har vuxen avsikt.

Om värdet är true och frågans safeSearch -frågeparameter har angetts till Strict, innehåller svaret endast diskussions grupps resultat, om tillämpligt.
Boolesk
alterationOverrideQuery Frågesträngen som ska användas för att tvinga Bing att använda den ursprungliga strängen. Om frågesträngen t. ex. är Saling downwind , är åsidosättande frågesträng + Saling downwind . Kom ihåg att koda frågesträngen som resulterar i % 2Bsaling + downwind .

objektet innehåller bara det här fältet om den ursprungliga frågesträngen innehåller en stavnings fel.
Sträng
alteredQuery Frågesträngen som Bing använde för att utföra frågan. Bing använder den ändrade frågesträngen om den ursprungliga frågesträngen innehåller stavfel. Om frågesträngen till exempel är är saling downwind den ändrade frågesträngen sailing downwind .

Objektet innehåller bara det här fältet om den ursprungliga frågesträngen innehåller en stavnings fel.
Sträng
askUserForLocation Ett booleskt värde som anger om Bing kräver användarens plats för att ge korrekta resultat. Om du har angett användarens plats med hjälp av huvudena X-MSEdge-ClientIP och X-search-location kan du ignorera det här fältet.

För plats medveten frågor, till exempel "Dagens väder" eller "restauranger nära mig" som behöver användarens plats för att ge korrekta resultat, är det här fältet inställt på Sant .

För plats medveten frågor som omfattar platsen (till exempel "Seattle-väder") är det här fältet inställt på falskt . Det här fältet är också inställt på falskt för frågor som inte är medvetna om, t. ex. "bäst säljare".
Boolesk
originalQuery Frågesträngen som anges i begäran. Sträng

RankingGroup

Definierar en Sök Resultat grupp, till exempel Mainline.

Namn Värde Typ
objekt En lista med Sök Resultat objekt som ska visas i gruppen. RankingItem[]

RankingItem

Definierar ett Sök Resultat objekt som ska visas. Mer information om hur du använder ID: n finns i använda rangordning för att visa resultat.

Namn Värde Typ
answerType Svaret som innehåller objektet som ska visas. Till exempel nyheter.

Använd typen för att hitta svaret i SearchResponse -objektet. Typen är namnet på ett SearchResponse fält.
Sträng
resultIndex Ett noll-baserat index för objektet i svaret.

Om objektet inte innehåller det här fältet, visar du alla objekt i svaret. Du kan till exempel Visa alla nyhets artiklar i svaret på diskussions gruppen.
Integer
värde Det ID som identifierar antingen ett svar för att visa eller ett objekt i ett svar att visa. Om ID: t identifierar ett svar visas alla svars objekt. Särskilj

RankingResponse

Definierar var på sidan med Sök Resultat sidans innehåll ska placeras och i vilken ordning.

Namn Värde Typ
mainline Sök resultaten som ska visas i Mainline. RankingGroup
Polen Sök resultaten som ska få den mest synliga behandlingen (till exempel, som visas ovanför Mainline och sido panelen). RankingGroup
marginal Sök resultatet visas i sid listen. RankingGroup

RelatedSearchAnswer

Definierar en lista över relaterade frågor som andra har gjort.

Namn Värde Typ
id Ett ID som unikt identifierar det relaterade Sök svaret.

Objektet innehåller bara det här fältet om rangordnings svaret anger att du visar alla relaterade sökningar i en grupp. Mer information om hur du använder ID: t finns i använda rangordning för att visa resultat.
Sträng
värde En lista över relaterade frågor som har gjorts av andra. Fråga[]

SearchResponse

Svarets toppnivå objekt för Sök begär Anden.

Som standard innehåller Sök-API alla svar om inte:

  • Frågan anger Frågeparametern responseFilter för att begränsa Svaren

  • En eller flera av Sök komponenterna returnerar inga resultat (t. ex. inga nyhets resultat är relevanta för frågan)

  • Prenumerations nyckeln har inte åtkomst till Sök komponenten.

Om tjänsten misstänker en denial of service-attack lyckas begäran (HTTP-status kod är 200 OK), men bröd texten i svaret är tom.

Namn Värde Typ
_type Typ tips. Sträng
vetenskap Svaret på ett uttryck för ett matematik uttryck eller en enhets konvertering. Vetenskap
poster En lista med entiteter som är relevanta för Sök frågan. EntityAnswer
avbildningar En lista med avbildningar som är relevanta för Sök frågan. Avbildningar
news En lista över nyhets artiklar som är relevanta för Sök frågan. Nya
queryContext Frågesträngen som Bing används för begäran.

Svaret innehåller bara kontexten om frågesträngen innehåller stavnings fel eller har vuxen avsikt.
QueryContext
rankingResponse Den ordning som Bing föreslår att du visar Sök resultatet i. RankingResponse
relatedSearches En lista över relaterade frågor som andra har gjort. RelatedSearchAnswer
spellSuggestions Frågesträngen som troligt vis representerar användarens avsikt. SpellSuggestions
Informationen Datum och tid för en eller flera geografiska platser. Informationen
Videos En lista med videor som är relevanta för Sök frågan. Videor
Webb sidor En lista med webb sidor som är relevanta för Sök frågan. Websvar

SpellSuggestions

Definierar en föreslagen frågesträng som troligt vis representerar användarens avsikt.

Sök resultaten innehåller det här svaret om Bing bestämmer att användaren kan ha tänkt att söka efter något annat. Om användaren t. ex. söker efter Alon brun , kan Bing avgöra om användaren förmodligen är avsedd att söka efter Alton Brown i stället (baserat på tidigare sökningar av andra i Alon Brown).

Namn Värde Typ
id Ett ID som unikt identifierar stavnings förslags svaret.

Du använder det här fältet när du använder ranknings svaret för att Visa stavnings förslagen. Mer information om hur du använder ID: t finns i använda rangordning för att visa resultat.
Sträng
värde En lista med föreslagna frågesträngar som kan representera användarens avsikt.

Listan innehåller bara ett Query objekt.
Fråga[]

TextAttribution

Definierar en avtals regel för oformaterad text-behörighet.

Namn Värde Typ
_type Ett typ tips, som är inställt på TextAttribution. Sträng
text Behörighets texten.

Text tilldelningen gäller för hela enheten och ska visas direkt efter entitetens presentation. Om det finns flera text-eller länk behörighets regler som inte anger ett mål, ska du sammanfoga dem och visa dem med hjälp av etiketten "data från:".
Sträng

TimeZone

Definierar data och tid för en eller flera geografiska platser.

Namn Värde Typ
otherCityTimes En lista över datum och tider för närliggande tids zoner. TimeZoneInformation[]
primaryCityTime Data och tid, i UTC, för den geografiska plats som anges i frågan.

Om frågan angav en specifik geografisk plats (till exempel en stad) innehåller det här objektet namnet på den geografiska platsen och aktuellt datum och tid, i UTC.

Om frågan har angett en allmän geografisk plats, till exempel ett tillstånd eller ett land, innehåller det här objektet datum och tid för den primära orten eller det angivna landets status i det angivna delstaten eller landet. Om platsen innehåller ytterligare tids zoner, otherCityTimes innehåller fältet data och tid för städer eller tillstånd som finns i andra tids zoner.
TimeZoneInformation

TimeZoneInformation

Definierar datum och tid för en geografisk plats.

Namn Värde Typ
sökvägen Namnet på den geografiska platsen.

Till exempel County; Fax Ort, delstat; Ort, delstat, land; eller tidszon.
Sträng
time De data och den tid som anges i formatet ÅÅÅÅ-MM-DDThh; mm: SS. ssssssZ. Sträng
utcOffset Förskjutningen från UTC. Till exempel UTC-7. Sträng

Websvar

Definierar en lista över relevanta länkar för webb sidor.

Namn Värde Typ
id Ett ID som unikt identifierar webb svaret.

Objektet innehåller bara det här fältet om rangordnings svaret antyder att du visar alla webb resultat i en grupp. Mer information om hur du använder ID: t finns i använda rangordning för att visa resultat.
Sträng
someResultsRemoved Ett booleskt värde som anger om svaret exkluderade vissa resultat från svaret. Om Bing utelämnade vissa resultat är värdet Sant . Boolesk
totalEstimatedMatches Det beräknade antalet webb sidor som är relevanta för frågan. Använd det här talet tillsammans med fråge parametrarna Count och offset för att placera resultaten på sidan. Lång
värde En lista med webb sidor som är relevanta för frågan. Webb sida[]
webSearchUrl URL: en till Bing search-resultaten för de begärda webb sidorna. Sträng

Historik

Definierar en webb sida som är relevant för frågan.

Namn Värde Typ
om Endast för internt bruk. Objekt
dateLastCrawled Senaste gången Bing crawlades webb sidan. Datumet är i formatet ÅÅÅÅ-MM-DDTHH: MM: SS. Till exempel 2015-04-13T05:23:39. Sträng
deepLinks En lista med länkar till relaterat innehåll som Bing hittades på webbplatsen som innehåller den här webb sidan.

WebpageObjektet i den här kontexten innehåller endast name url fälten,, urlPingSuffix och snippet .
Webb sida[]
displayUrl Webb sidans visnings webb adress. URL: en är endast avsedd för visning och är inte korrekt formaterad. Sträng
id Ett ID som unikt identifierar den här webb sidan i listan med webb resultat.

Objektet innehåller bara det här fältet om rangordnings svaret anger att du blandar webb sidorna med de andra Sök resultaten. Varje webb sida innehåller ett ID som matchar ett ID i rangordnings svaret. Mer information finns i använda rangordning för att visa resultat.
Sträng
Namn Namnet på webb sidan.

Använd det här namnet tillsammans med url för att skapa en hyperlänk som när användaren klickar på webb sidan.
Sträng
omnämnanden Endast för internt bruk. Objekt
searchTags En lista med söktaggar som webb sidans ägare har angett på webb sidan. API: et returnerar bara indexerade Sök taggar.

nameFältet för MetaTag objektet innehåller den indexerade Sök taggen. Sök taggar börjar med search. * (till exempel search. assetId). contentFältet innehåller taggens värde.
Metatagg[]
bitar Ett kodfragment med text från webb sidan som beskriver dess innehåll. Sträng
adresser Webb adressen till webb sidan.

Använd den här webb adressen tillsammans med name för att skapa en hyperlänk som när användaren klickar på webb sidan.
Sträng

Entitetstyper

Det här avsnittet innehåller möjliga enhets tips. Tipsen är grupperade efter kategori av entiteter.

Följande är de grundläggande enhets typerna.

  • Allmänna
  • Person
  • Plats
  • Media
  • Organisation

Följande är de entiteter-tips som faller under bastypen.

  • Attraktion
  • City
  • Kontinent
  • Land
  • Hotell
  • Egen
  • LocalBusiness
  • Plats
  • MinorRegion
  • Stadsdel
  • Övrigt
  • PointOfInterest
  • Postnummer
  • RadioStation
  • Region
  • Restauranger
  • Tillstånd
  • StreetAddress
  • Del området
  • TouristAttraction
  • Resa

Följande är de entiteter-tips som faller under medie bastypen.

  • Bok
  • Filmspelare
  • TelevisionSeason
  • TelevisionShow
  • VideoGame

Följande är de event-relaterade entitets tipsen.

  • Händelse

Här följer de branschbaserade tips om entiteter.

  • Skådespelare
  • Artister
  • Jurist

Följande är de utbildnings tips som är relaterade till utbildningen.

  • CollegeOrUniversity
  • Bänk
  • Särskildhet

Följande är relaterade tips om entiteter.

  • Animalie
  • Sidvagn
  • Narkotika
  • Kost
  • Produkt
  • SportsTeam

Felkoder

Följande är möjliga HTTP-statuskoder som en begäran returnerar.

Statuskod Beskrivning
200 Åtgärden lyckades.
400 En av frågeparametrarna saknas eller är ogiltig.
401 Prenumerationsnyckeln saknas eller är inte giltig.
403 Användaren autentiseras (till exempel en giltig prenumerationsnyckel) men har inte behörighet till den begärda resursen.

Bing kan också returnera den här statusen om anroparen överskrider sina frågor per månadskvot.
410 Begäran använde HTTP i stället för HTTPS-protokollet. HTTPS är det enda protokoll som stöds.
429 Anroparen överskred sin kvot för frågor per sekund.
500 Oväntat serverfel.

Om begäran misslyckas innehåller svaret ett ErrorResponse-objekt som innehåller en lista över felobjekt som beskriver vad som orsakade felet. Om felet är relaterat till en parameter parameter identifierar fältet den parameter som är problemet. Och om felet är relaterat till ett parametervärde value identifierar fältet det värde som inte är giltigt.

{
  "_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."
    }
  ]
}

Följande är möjliga värden för felkod och underfelkod.

Kod Underkod Beskrivning
ServerError UnexpectedError
ResourceError
Inte implementerad
HTTP-statuskoden är 500.
InvalidRequest ParameterMissing
ParameterInvalidValue
HttpNotAllowed
Blockerad
Bing returnerar InvalidRequest när någon del av begäran inte är giltig. Till exempel saknas en obligatorisk parameter eller så är ett parametervärde inte giltigt.

Om felet är ParameterMissing eller ParameterInvalidValue är HTTP-statuskoden 400.

Om du använder HTTP-protokollet i stället för HTTPS returnerar Bing HttpNotAllowed och HTTP-statuskoden är 410.
RateLimitExceeded Inga underordnade koder Bing returnerar RateLimitExceeded när du överskrider dina frågor per sekund (QPS) eller frågor per månad (QPM) kvot.

Om du överskrider QPS returnerar Bing HTTP-statuskod 429 och om du överskrider QPM returnerar Bing 403.
InvalidAuthorization AuthorizationMissing
AuthorizationRedundancy
Bing returnerar InvalidAuthorization när Bing inte kan autentisera anroparen. Till exempel saknas Ocp-Apim-Subscription-Key rubriken eller så är prenumerationsnyckeln inte giltig.

Redundans inträffar om du anger mer än en autentiseringsmetod.

Om felet är InvalidAuthorization är HTTP-statuskoden 401.
InsufficientAuthorization AuthorizationDisabled
AuthorizationExpired
Bing returnerar InsufficientAuthorization när anroparen inte har behörighet att komma åt resursen. Detta kan inträffa om prenumerationsnyckeln har inaktiverats eller har upphört att gälla.

Om felet är InsufficientAuthorization är HTTP-statuskoden 403.

Marknads koder

I följande tabell visas de marknadskodvärden som du kan använda för att ange mkt frågeparametern. Bing returnerar innehåll för endast dessa marknader. Listan kan komma att ändras.

En lista över landskoder som du kan ange i cc frågeparametern finns i Landskoder.

Land/region Språk Marknadskod
Argentina Spanska es-AR
Australien Engelska en-AU
Österrike Tyska de-AT
Belgien Nederländska nl-BE
Belgien Franska fr-BE
Brasilien Portugisiska pt-BR
Kanada Engelska en-CA
Kanada Franska fr-CA
Chile Spanska es-CL
Danmark Danska da-DK
Finland Finska fi-FI
Frankrike Franska fr-FR
Tyskland Tyska de-DE
Folkrepubliken Kinas särskilda administrativa region Hongkong Traditionell kinesiska zh-HK
Indien Engelska en-IN
Indonesien Engelska en-ID
Italien Italienska it-IT
Japan Japanska ja-JP
Korea Koreanska ko-KR
Malaysia Engelska en-MY
Mexico Spanska es-MX
Nederländerna Nederländska nl-NL
Nya Zeeland Engelska en-NZ
Norge Norska No-no
Folkrepubliken Kina Kinesiska zh-CN
Polen Polska pl-PL
Filippinerna Engelska en-PH
Ryssland Ryska ru-RU
Sydafrika Engelska en-ZA
Spanien Spanska es-ES
Sverige Svenska sv-SE
Schweiz Franska fr-CH
Schweiz Tyska de-CH
Taiwan Traditionell kinesiska zh-TW
Turkiet Turkiska tr-TR
Storbritannien Engelska en-GB
USA Engelska sv-SE
USA Spanska es-US

Landskoder

Följande är de landskoder som du kan ange i cc frågeparametern. Listan kan komma att ändras.

Land/region Landskod
Argentina AR
Australien AU
Österrike AT
Belgien BE
Brasilien BR
Kanada CA
Chile CL
Danmark DK
Finland FI
Frankrike FR
Tyskland DE
Folkrepubliken Kinas särskilda administrativa region Hongkong HK
Indien IN
Indonesien ID
Italien IT
Japan JP
Korea KR
Malaysia MY
Mexico MX
Nederländerna NL
Nya Zeeland NZ
Norge NO
Folkrepubliken Kina CN
Polen PL
Portugal PT
Filippinerna PH
Ryssland RU
Saudiarabien SA
Sydafrika ZA
Spanien ES
Sverige SE
Schweiz CH
Taiwan TW
Turkiet TR
Storbritannien GB
USA USA

Språk som stöds i Bing

Följande är de Bing som stöds och som du kan ange i setLang frågeparametern. Listan kan komma att ändras.

Språk som stöds Språkkod
Arabiska Ar
Baskiska Eu
Bengali Bn
Bulgariska Bg
Katalanska ca
Kinesiska (förenklad) zh-hans
Kinesiska (traditionell) zh-hant
Kroatiska tim
Tjeckiska Cs
Danska da
Nederländska nl
Engelska en
English-United Storbritannien en-gb
Estniska Et
Finska fi
Franska fr
Galiciska Gl
Tyska de
Gujarati Gu
Hebreiska Han
Hindi hi
Ungerska Hu
Isländska är
Italienska it
Japanska Jp
Kannada Kn
Koreanska Ko
Lettiska Lv
Litauiska lt
Malajiska Ms
Malayalam Ml
Marathi Mr
Norska (bokmål) Nb
Polska Pl
Portugisiska (Brasilien) pt-br
Portugisiska (Portugal) pt-pt
Punjabi Pa
Rumänska Ro
Ryska ru
Serbiska (cyrylic) Sr
Slovakiska Sk
Slovenska Sl
Spanska es
Svenska sv
Tamilska ta
Telugu te
Thailändska Th
Turkiska Tr
Ukrainska Storbritannien
Vietnamesiska vi