Partager via

Obtenez des images à partir du web avec l’API Recherche d’images Bing

  • Article

Avertissement

Le 30 octobre 2020, les API de recherche Bing sont passées des services Azure AI aux services de recherche Bing. Cette documentation est fournie à des fins de référence uniquement. Pour accéder à la documentation mise à jour, consultez la documentation de l’API Recherche Bing. Pour obtenir des instructions sur la création de nouvelles ressources Azure pour Recherche Bing, consultez Créer une ressource Recherche Bing à l’aide de Place de marché Azure.

Lorsque vous utilisez l’API REST Recherche d’images Bing, vous pouvez obtenir des images web qui sont liées au terme de votre recherche en envoyant la requête GET suivante :

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

Utilisez le paramètre de requête q pour votre terme de recherche codé URL. Par exemple, si vous saisissez sailing dinghies, définissez q avec la valeur sailing+dinghies ou sailing%20dinghies.

Important

  • Toutes les requêtes doivent provenir d’un serveur, et non d’un client.
  • Si vous appelez l’une des API de recherche Bing pour la première fois, n’incluez pas l’en-tête ID client. Indiquez uniquement l’ID client si vous avez précédemment appelé une API Bing qui a renvoyé un ID client pour la combinaison utilisateur/appareil.

Obtenir des images à partir d’un domaine web spécifique

Pour obtenir des images à partir d’un domaine spécifique, utilisez l’opérateur de requête site:.

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

Notes

Les réponses aux requêtes utilisant l’opérateur site: peuvent inclure du contenu pour adultes, quel que soit le paramètre safeSearch. N’utilisez site: que si vous connaissez le contenu du domaine.

Filtrer les images

Par défaut, l’API Recherche d’images renvoie toutes les images ayant un rapport avec la requête. Si vous souhaitez filtrer les images que Bing renvoie (par exemple, pour ne recevoir que des images avec un arrière-plan transparent ou d’une taille spécifique), utilisez les paramètres de requête suivants :

  • aspect : filtre les images selon leurs proportions (par exemple, standard ou grand écran).
  • color : filtre les images selon leur couleur (couleur dominante ou noir et blanc).
  • freshness : filtre les images selon leur ancienneté (par exemple, celles découvertes par Bing la semaine dernière).
  • height, width : filtre les images selon leur largeur et leur hauteur.
  • imageContent : filtre les images selon leur contenu (par exemple, celles qui montrent uniquement le visage d’une personne).
  • imageType : filtre les images selon leur type (images clipart, images GIF animées, arrière-plans transparents, etc.).
  • license : filtre les images selon le type de contrat de licence associé au site.
  • size : filtre les images selon leur taille (par exemple, petites images jusqu’à 200 x 200 pixels).

Pour obtenir des images à partir d’un domaine spécifique, utilisez l’opérateur de requête site:.

L’exemple suivant montre comment obtenir les petites images découvertes par Bing la semaine dernière sur le site ContosoSailing.com.

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 de réponse de Recherche d’images Bing

Le message de réponse de Bing contient une réponse Images comprenant une liste d’images qu’Azure AI services a déterminé comme étant pertinentes pour la requête. Chaque objet Image de la liste inclut les informations suivantes sur l’image : l’URL, sa taille, ses dimensions, son format d’encodage, une URL vers une miniature de l’image et les dimensions de la miniature.

Notes

  • Les images doivent être affichées dans l’ordre dans lequel elles apparaissent dans la réponse.
  • Étant donné que les paramètres et formats d’URL sont susceptibles de changer sans préavis, utilisez toutes les URL telles quelles. Vous ne devez pas créer de dépendances par rapport au format d’URL ou aux paramètres sauf indication contraire.
{
    "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"
},

Quand vous appelez l’API Recherche d’images Bing, Bing retourne une liste de résultats. La liste est un sous-ensemble du nombre total de résultats en rapport avec la requête. Le champ totalEstimatedMatches de la réponse contient une estimation du nombre d’images disponibles pour visualisation. Pour plus d’informations sur la manière de parcourir les images restantes, consultez Parcourir les images.

Étapes suivantes

Si vous n’avez pas déjà essayé l’API Recherche d’images Bing, essayez un démarrage rapide. Si vous recherchez quelque chose de plus complexe, suivez le didacticiel de création d’une application web à une seule page.