Door de resultaten van de Zoeken in Bing API's bladeren

  • Artikel

Waarschuwing

Op 30 oktober 2020 zijn de Zoeken in Bing API's verplaatst van Azure AI-services naar Zoeken in Bing Services. Deze documentatie is alleen bedoeld ter referentie. Zie de bing-documentatie voor zoeken-API voor bijgewerkte documentatie. Zie Een Zoeken in Bing-resource maken via de Azure Marketplace voor instructies over het maken van nieuwe Azure-resources voor Bing Search.

Wanneer u een aanroep verzendt naar de Bing Web-, Aangepaste, Afbeeldings-, Nieuws- of Video's zoeken-API's, retourneert Bing een subset van het totale aantal resultaten dat mogelijk relevant is voor de query. Als u het geschatte totale aantal beschikbare resultaten wilt ophalen, opent u het veld van totalEstimatedMatches het antwoordobject.

Bijvoorbeeld:

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

Bladeren door zoekresultaten

Als u door de beschikbare resultaten wilt bladeren, gebruikt u de count queryparameters en offset bij het verzenden van uw aanvraag.

Notitie

  • Paging met de Bing-API's voor video, afbeeldingen en nieuws is alleen van toepassing op algemene zoekopdrachten naar video 's (/video/search), nieuws (/news/search) en afbeeldingen (/image/search). Pageren door trending onderwerpen en categorieën wordt niet ondersteund.
  • Het TotalEstimatedMatches veld is een schatting van het totale aantal zoekresultaten voor de huidige query. Wanneer u de count parameters en offset instelt, kan deze schatting worden gewijzigd.
Parameter Beschrijving
count Hiermee geeft u het aantal resultaten dat moet worden geretourneerd in het antwoord. Houd er rekening mee dat de standaardwaarde van counten het maximum aantal resultaten dat u kunt aanvragen, verschilt per API. U vindt deze waarden in de referentiedocumentatie onder Volgende stappen.
offset Hiermee geeft u het aantal resultaten dat moet worden overgeslagen. De offset is gebaseerd op nul en moet kleiner zijn dan (totalEstimatedMatches - count).

Als u bijvoorbeeld 15 resultaten per pagina wilt weergeven, stelt count u in op 15 en offset op 0 om de eerste pagina met resultaten te krijgen. Voor elke volgende API-aanroep zou u het met 15 verhogen offset . In het volgende voorbeeld worden 15 webpagina's aangevraagd vanaf offset 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

Als u de standaardwaarde count gebruikt, hoeft u alleen de offset queryparameter op te geven in uw API-aanroepen.

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

Wanneer u de Bing Afbeeldingen en Video-API's gebruikt, kunt u de nextOffset waarde gebruiken om dubbele zoekresultaten te voorkomen. Haal de waarde op uit de Images of-antwoordobjecten Videos en gebruik deze in uw aanvragen met de offset parameter .

Notitie

De Bing Webzoekopdrachten-API retourneert zoekresultaten die webpagina's, afbeeldingen, video's en nieuws kunnen bevatten. Wanneer u door zoekresultaten bladert vanuit de Bing Webzoekopdrachten-API, wisselt u alleen webpagina's en niet andere antwoordtypen, zoals afbeeldingen of nieuws. Zoekresultaten in WebPage objecten kunnen resultaten bevatten die ook in andere antwoordtypen worden weergegeven.

Als u de responseFilter queryparameter gebruikt zonder filterwaarden op te geven, moet u de count parameters en offset niet gebruiken.

Volgende stappen