Abrufen von Bildern aus dem Web mit der Bing-Bildersuche-API

  • 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 mit der Bing-Bildersuche-REST-API Bilder aus dem Web abrufen, erhalten Sie Bilder, die sich auf Ihren Suchbegriff beziehen, indem Sie die folgende GET-Anforderung senden:

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
X-MSEdge-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com

Verwenden Sie den Abfrageparameter q für Ihren URL-codierten Suchbegriff. Wenn Sie z. B. sailing dinghies eingeben, legen Sie q auf sailing+dinghies oder sailing%20dinghies fest.

Wichtig

  • Alle Anforderungen müssen über einen Server erfolgen, nicht über einen Client.
  • Lassen Sie den Client-ID-Header weg, falls Sie zuvor noch keine APIs für die Bing-Suche aufgerufen haben. Binden Sie die Client-ID nur ein, wenn Sie bereits eine Bing-API aufgerufen haben, mit der eine Client-ID für die Kombination aus Benutzer und Gerät zurückgegeben wurde.

Abrufen von Bildern aus einer bestimmten Webdomäne

Wenn Sie Bilder aus einer bestimmten Domäne abrufen möchten, verwenden Sie den Abfrageoperator site:.

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies+site:contososailing.com&mkt=en-us HTTP/1.1

Hinweis

Antworten auf Abfragen, für die der Operator site: verwendet wird, können unter Umständen nicht jugendfreien Inhalt enthalten, und zwar unabhängig von der Einstellung safeSearch. Verwenden Sie site: nur, wenn Sie den Inhalt der Domäne kennen.

Filtern von Bildern

Die Bildersuche-API gibt standardmäßig alle Bilder zurück, die für die Abfrage relevant sind. Wenn Sie die von Bing zurückgegebenen Bilder filtern möchten (um z. B. nur Bilder mit einem durchsichtigen Hintergrund oder einer bestimmten Größe zurückzugeben), verwenden Sie die folgenden Abfrageparameter:

  • aspect: Filtert Bilder nach Seitenverhältnis (beispielsweise Standard oder Breitbild).
  • color: Filtert Bilder nach dominanter Farbe oder Schwarzweiß.
  • freshness: Filtert Bilder nach Alter (beispielsweise Bilder, die von Bing in der letzten Woche gefunden wurden).
  • height, width: Filtert Bilder nach Breite und Höhe.
  • imageContent: Filtert Bilder nach Inhalt (beispielsweise Bilder, die nur das Gesicht einer Person zeigen).
  • imageType: Filtert Bilder nach Typ (beispielsweise ClipArts, animierte GIFs oder transparente Hintergründe).
  • license: Filtert Bilder nach Art der Websitelizenz.
  • size: Filtert Bilder nach Größe (beispielsweise kleine Bilder bis zu einer Größe von 200 x 200 Pixel).

Wenn Sie Bilder aus einer bestimmten Domäne abrufen möchten, verwenden Sie den Abfrageoperator site:.

Das folgende Beispiel zeigt, wie Sie von ContosoSailing.com kleine Bilder abrufen, die Bing in der letzten Woche gefunden hat.

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies+site:contososailing.com&size=small&freshness=week&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
X-MSEdge-ClientIP: 999.999.999.999  
X-Search-Location: lat:47.60357;long:-122.3295;re:100  
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>  
Host: api.cognitive.microsoft.com

Format von Antworten der Bing-Bildersuche

Die Antwortnachricht von Bing enthält eine Antwort vom Typ Bilder mit einer Liste mit Bildern, die von Azure KI Services als für die Abfrage relevant ermittelt wurden. Jedes Image-Objekt der Liste enthält die folgenden Informationen zum Bild: URL, Größe, Abmessungen, Codierungsformat, URL für eine Miniaturansicht des Bilds und die Abmessungen der Miniaturansicht.

Hinweis

  • Bilder müssen in der Reihenfolge angezeigt werden, die von der Antwort vorgegeben wird.
  • Da sich URL-Formate und -Parameter ohne Vorankündigung ändern können, sollten Sie alle URLs in der vorliegenden Form verwenden. Es sollten keine Abhängigkeiten von URL-Formaten oder -Parametern bestehen, außer wenn dies angegeben ist.
{
    "name": "Rich Passage Sailing Dinghy",
    "webSearchUrl": "https:\/\/www.bing.com\/cr?IG=73118C8B4E3...",
    "thumbnailUrl": "https:\/\/tse1.mm.bing.net\/th?id=OIP.GNarK7m...",
    "datePublished": "2011-10-29T11:26:00",
    "contentUrl": "http:\/\/www.bing.com\/cr?IG=73118C8B4E3D4C3...",
    "hostPageUrl": "http:\/\/www.bing.com\/cr?IG=73118C8B4E3D4C3687...",
    "contentSize": "79239 B",
    "encodingFormat": "jpeg",
    "hostPageDisplayUrl": "en.contoso.org\/wiki\/File:Rich_Passage...",
    "width": 526,
    "height": 688,
    "thumbnail": {
        "width": 229,
        "height": 300
    },
    "imageInsightsToken": "ccid_GNarK7ma*mid_CCF85447ADA6...",
    "insightsSourcesSummary": {
        "shoppingSourcesCount": 0,
        "recipeSourcesCount": 0
    },
    "imageId": "CCF85447ADA6FFF9E96E7DF0B796F7A86E34593",
    "accentColor": "376094"
},

Wenn Sie die Bing-Bildersuche-API aufrufen, gibt Bing eine Liste mit Ergebnissen zurück. Bei der Liste handelt es sich um eine Teilmenge der gesamten Ergebnisse, die für die Abfrage relevant sind. Das Feld totalEstimatedMatches der Antwort enthält die geschätzte Anzahl von Bildern, die angezeigt werden können. Ausführliche Informationen zum Blättern durch die restlichen Bilder finden Sie hier.

Nächste Schritte

Verwenden Sie die Schnellstartanleitung, falls Sie die Bing-Bildersuche-API noch nicht ausprobiert haben. Falls Sie nach einem komplexeren Ansatz suchen, können Sie das Tutorial zur Erstellung einer Einzelseiten-Web-App ausprobieren.