Freigeben über

Durchblättern der Suchergebnisse der Bing-Suche-APIs

  • Artikel

Warnung

Am 30. Oktober 2020 wurden die Bing-Suche-APIs aus den Azure KI Services in die Bing-Suchdienste verschoben. Diese Dokumentation wird nur zu Referenzzwecken bereitgestellt. Eine aktualisierte Dokumentation finden Sie in der Dokumentation zu den Bing-Suche-APIs. Anweisungen zum Erstellen neuer Azure-Ressourcen für die Bing-Suche finden Sie unter Erstellen einer Ressource für die Bing-Suche über Azure Marketplace.

Wenn Sie einen Aufruf an die Bing-Suche-APIs Web, Custom, Image, News oder Video senden, gibt Bing eine Teilmenge der Gesamtzahl der Ergebnisse zurück, die für die Abfrage relevant sein können. Um die geschätzte Gesamtzahl der verfügbaren Ergebnisse abzurufen, greifen Sie auf das totalEstimatedMatches-Feld des Antwortobjekts zu.

Beispiel:

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

Durchblättern von Suchergebnissen

Um durch die verfügbaren Ergebnisse zu blättern, verwenden Sie beim Senden Ihrer Abfrage die Abfrageparametercount und offset.

Hinweis

  • Das Durchblättern beschränkt sich bei den Bing-APIs Video, Image und News nur auf allgemeine Video- (/video/search), Nachrichten- (/news/search) und Bildsuchen (/image/search). Das Durchblättern von Trendthemen und Kategorien wird nicht unterstützt.
  • Das Feld TotalEstimatedMatches gibt eine Schätzung der Gesamtzahl der Suchergebnisse für die aktuelle Abfrage an. Wenn Sie die Parameter count und offset festlegen, ändert sich diese Schätzung möglicherweise.
Parameter Beschreibung
count Gibt die Anzahl der Ergebnisse an, die in der Antwort zurückgegeben werden sollen. Beachten Sie, dass sich der Standardwert von count und die maximale Zahl der Ergebnisse, die abgerufen werden können, bei den einzelnen APIs unterscheiden. Sie finden diese Werte in der Referenzdokumentation unter Nächste Schritte.
offset Gibt die Anzahl der zu überspringenden Ergebnisse an. Der offset-Parameter ist nullbasiert und sollte kleiner sein als (totalEstimatedMatches - count).

Wenn Sie pro Seite z.B. 15 Artikel anzeigen möchten, legen Sie count auf 15 und offset auf 0 fest, um die erste Ergebnisseite abzurufen. Für jeden nachfolgenden API-Aufruf würden Sie offset um 15 heraufsetzen. Im Beispiel unten werden 15 Webseiten ab Offset 45 angefordert.

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

Wenn Sie den Standardwert von count verwenden, müssen Sie in Ihren API-Aufrufen nur den Abfrageparameter offset angeben.

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

Wenn Sie die Bing-Bildersuche- und Bing-Videosuche-APIs verwenden, können Sie mit dem Wert nextOffset doppelte Suchergebnisse vermeiden. Rufen Sie den Wert aus den Antwortobjekten Images oder Videos ab, und verwenden Sie ihn in Ihren Anforderungen mit dem offset-Parameter.

Hinweis

Die Bing-Websuche-API gibt Suchergebnisse zurück, die Webseiten, Bilder, Videos und Nachrichten enthalten können. Wenn Sie durch die Suchergebnisse aus dem Bing-Websuche-API blättern, werden nur Webseiten angezeigt, keine anderen Antworttypen, wie etwa Bilder oder Nachrichten. Suchergebnisse in WebPage-Objekten enthalten möglicherweise Ergebnisse, die auch in anderen Antworttypen angezeigt werden.

Wenn Sie den responseFilter-Abfrageparameter ohne Angabe von Filterwerten verwenden, verwenden Sie die Parameter count und offset nicht.

Nächste Schritte