Obtención de imágenes desde la web con Bing Image Search API

  • Artículo

Advertencia

El 30 de octubre de 2020, las API de Bing Search se trasladaron de los servicios de Azure AI a los servicios de Bing Search. Esta documentación se proporciona solo como referencia. Para obtener documentación actualizada, consulte la documentación de Bing Search API. Para obtener instrucciones sobre cómo crear nuevos recursos de Azure para Bing Search, consulte el artículo sobre la creación de un recurso de Bing Search a través de Azure Marketplace.

Cuando use la API REST de Bing Image Search, puede enviar la solicitud GET siguiente para obtener de la web imágenes relacionadas con el término de búsqueda:

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

Use el parámetro de consulta q para el término de búsqueda con codificación URL. Por ejemplo, si escribe sailing dinghies, establezca q en sailing+dinghies o sailing%20dinghies.

Importante

  • Todas las solicitudes se deben realizar desde un servidor y no desde un cliente.
  • Si es la primera vez que llama a cualquiera de las API de búsqueda de Bing, no incluya el encabezado de identificador de cliente. Solo debe incluir el identificador de cliente si se ha llamado previamente a una API de Bing que ha devuelto un identificador de cliente para esa combinación de usuario y dispositivo.

Obtención de imágenes de un dominio web específico

Para obtener imágenes de un dominio específico, utilice el operador de consulta site:.

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

Nota

Las respuestas a las consultas que utilizan el operador site: pueden incluir contenido para adultos, independientemente de la configuración de safeSearch. Use site: solo si es consciente del contenido del dominio.

Filtrado de imágenes

De forma predeterminada, Image Search API devuelve todas las imágenes que están relacionadas con la consulta. Si quiere filtrar las imágenes que devuelve Bing (por ejemplo, para devolver solo imágenes con un fondo transparente o imágenes de un tamaño específico), use los siguientes parámetros de consulta:

  • aspect: filtra las imágenes según la relación de aspecto (por ejemplo, imágenes de pantalla estándar o extendida).
  • color: filtra las imágenes por color dominante o blanco y negro.
  • freshness: filtra las imágenes por edad (por ejemplo, imágenes detectadas por Bing en la última semana).
  • height, width: filtra las imágenes por ancho y alto.
  • imageContent: filtra las imágenes por contenido (por ejemplo, las imágenes que muestran solo la cara de una persona).
  • imageType: filtra las imágenes por tipo (por ejemplo, imágenes prediseñadas, GIF animados o fondos transparentes).
  • license: filtra las imágenes por el tipo de licencia asociado al sitio.
  • size: filtra las imágenes por tamaño, como las pequeñas imágenes de hasta 200 x 200 píxeles.

Para obtener imágenes de un dominio específico, utilice el operador de consulta site:.

En el ejemplo siguiente se muestra cómo obtener imágenes pequeñas de ContosoSailing.com que Bing ha detectado en la última semana.

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

Formato de respuesta de Bing Image Search

El mensaje de respuesta de Bing contiene una respuesta Images que contiene una lista de imágenes que los servicios de Azure AI han determinado como pertinentes para la consulta. Cada objeto Image de la lista incluye la siguiente información sobre la imagen: la dirección URL, su tamaño, sus dimensiones, su formato de codificación, la dirección URL de una vista en miniatura de la imagen y las dimensiones de la miniatura.

Nota

  • Debe mostrar las imágenes en el orden proporcionado en la respuesta.
  • Como los formatos y los parámetros de dirección URL están sujetos a cambios sin previo aviso, use todas las direcciones URL tal y como están. No debe tomar dependencias en el formato o los parámetros de dirección URL, excepto donde se indique.
{
    "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"
},

Cuando se llama a Bing Image Search API, Bing devuelve una lista de resultados. La lista es un subconjunto del número total de resultados que están relacionados con la consulta. El campo totalEstimatedMatches de la respuesta contiene una estimación del número de imágenes que están disponibles para ver. Para obtener más información acerca de cómo desplazarse por las páginas del resto de las imágenes, consulte Paginación de imágenes.

Pasos siguientes

Si no ha probado Bing Image Search API antes, consulte una guía de inicio rápido. Si busca algo más complejo, consulte el tutorial para crear una aplicación web de una sola página.