Så här bläddrar du igenom resultat från Bing-sökning API:er

  • Artikel

Varning

Den 30 oktober 2020 flyttade Bing-sökning API:er från Azure AI-tjänster till Bing-sökning Services. Den här dokumentationen tillhandahålls endast som referens. Uppdaterad dokumentation finns i dokumentationen för API:et för Bing-sökning. Anvisningar om hur du skapar nya Azure-resurser för Bing-sökning finns i Skapa en Bing-sökning resurs via Azure Marketplace.

När du skickar ett anrop till API:erna för Bing Web, Custom, Image, News eller Video Search returnerar Bing en delmängd av det totala antalet resultat som kan vara relevanta för frågan. Om du vill hämta det uppskattade totala antalet tillgängliga resultat öppnar du svarsobjektets totalEstimatedMatches fält.

Exempel:

{
    "_type" : "SearchResponse",
    "webPages" : {
        "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3A43CA...",
        "totalEstimatedMatches" : 262000,
        "value" : [...]
    }
}

Växling via sökresultat

Om du vill bläddra igenom de tillgängliga resultaten använder count du frågeparametrarna och offset när du skickar din begäran.

Anteckning

  • Växling med API:er för video, bild och nyheter i Bing gäller endast för allmänna videosökningar (/video/search), nyheter (/news/search) och bildsökningar (/image/search). Växling genom populära ämnen och kategorier stöds inte.
  • Fältet TotalEstimatedMatches är en uppskattning av det totala antalet sökresultat för den aktuella frågan. När du anger parametrarna och offset kan den här uppskattningen count ändras.
Parameter Beskrivning
count Anger hur många resultat som ska returneras i svaret. Observera att standardvärdet countför och det maximala antalet resultat som du kan begära varierar beroende på API. Du hittar dessa värden i referensdokumentationen under Nästa steg.
offset Anger hur många resultat som ska hoppa över. offset är nollbaserad och bör vara mindre än ( - totalEstimatedMatchescount).

Om du till exempel vill visa 15 resultat per sida anger count du till 15 och offset 0 för att få den första sidan med resultat. För varje efterföljande API-anrop ökar du med offset 15. I följande exempel begärs 15 webbsidor med början vid förskjutning 45.

GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&count=15&offset=45&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
Host: api.cognitive.microsoft.com

Om du använder standardvärdet count behöver du bara ange offset frågeparametern i dina API-anrop.

GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&offset=45&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
Host: api.cognitive.microsoft.com

När du använder API:er för bild och video i Bing kan du använda nextOffset värdet för att undvika duplicerade sökresultat. Hämta värdet från eller svarsobjekten Images och använd det i dina begäranden med parametern offset .Videos

Anteckning

API:et för webbsökning i Bing returnerar sökresultat som kan innehålla webbsidor, bilder, videor och nyheter. När du bläddrar igenom sökresultat från API:et för webbsökning i Bing växlingsbart endast webbsidor och inte andra svarstyper, till exempel bilder eller nyheter. Sökresultat i WebPage objekt kan även innehålla resultat som visas i andra svarstyper.

Om du använder responseFilter frågeparametern utan att ange några filtervärden ska du inte använda parametrarna count och offset .

Nästa steg