Compartilhar via

Obter imagens da Web com a API de Pesquisa de Imagem do Bing

  • Artigo

Aviso

Em 30 de outubro de 2020, as APIs de Pesquisa do Bing foram migradas dos serviços de IA do Azure para os Serviços de Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter a documentação atualizada, consulte a documentação da API de pesquisa do Bing. Para obter instruções sobre como criar novos recursos do Azure para a Pesquisa do Bing, consulte Criar um recurso de Pesquisa do Bing por meio do Azure Marketplace.

Ao usar a API REST de Pesquisa de Imagem do Bing, você pode obter imagens da Web relacionadas ao seu termo de pesquisa, enviando a seguinte solicitação GET:

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 o parâmetro de pesquisa q para o termo de pesquisa codificado em URL. Por exemplo, se você inserir sailing dinghies (bote à vela), defina q como sailing+dinghies ou sailing%20dinghies.

Importante

  • Todas as solicitações precisam ser feitas por meio de um servidor, e não de um cliente.
  • Se essa é a primeira vez que você chama uma das APIs de Pesquisa do Bing, não inclua o cabeçalho da ID do cliente. Só inclua a ID do cliente se já tiver chamado uma API do Bing que retornou uma ID do cliente para a combinação de usuário e dispositivo.

Obter imagens de um domínio da Web específico

Para obter imagens de um domínio específico, use o 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

Observação

As respostas a consultas usando o operador site: podem incluir conteúdo para adultos, independentemente da configuração safeSearch. Só use site: se estiver ciente do conteúdo do domínio.

Filtrar imagens

Por padrão, a API de Pesquisa de Imagem retorna todas as imagens que são relevantes para a consulta. Caso deseje filtrar as imagens retornadas pelo Bing (por exemplo, para retornar somente as imagens com uma tela de fundo transparente ou um tamanho específico), use os seguintes parâmetros de consulta:

  • aspecto— Filtrar imagens por taxa de proporção (por exemplo, imagens de tela grande ou padrão).
  • cor— Filtrar imagens por cor dominante ou preto e branco.
  • atualização— Filtrar imagens por idade (por exemplo, imagens descobertas pelo Bing na última semana).
  • altura, largura— Filtrar imagens por largura e altura.
  • imageContent— Filtrar imagens por conteúdo (por exemplo, imagens que mostram apenas o rosto de uma pessoa).
  • imageType— Filtrar imagens por tipo (por exemplo, clip-art, GIFs animados ou planos de fundo transparentes).
  • licença— Filtrar imagens pelo tipo de licença associado ao site.
  • tamanho— Filtrar imagens por tamanho, como imagens pequenas de até 200x200 pixels.

Para obter imagens de um domínio específico, use o operador de consulta site:.

O exemplo a seguir mostra como obter imagens pequenas de ContosoSailing.com que o Bing descobriu na ú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 resposta da Pesquisa de Imagem do Bing

A mensagem de resposta do Bing contém uma resposta Imagens que contém uma lista de imagens que os serviços de IA do Azure consideraram relevantes para a consulta. Cada objeto Image da lista inclui as seguintes informações sobre a imagem: a URL, seu tamanho, suas dimensões, seu formato de codificação, uma URL para uma miniatura da imagem e as dimensões da miniatura.

Observação

  • As imagens precisam ser exibidas na ordem fornecida na resposta.
  • Porque os formatos de URL e os parâmetros estão sujeitos a alterações sem aviso prévio, use todas as URLs no estado em que se encontram. Você não deveria receber dependências no formato de URL ou parâmetros, exceto o quando observado.
{
    "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"
},

Quando você chamar a API de Pesquisa de Imagem do Bing, o Bing retorna uma lista de resultados. A lista é um subconjunto do número total de resultados que são relevantes para a consulta. O campo totalEstimatedMatches da resposta contém uma estimativa do número de imagens disponíveis para exibição. Para obter detalhes sobre como percorrer as imagens restantes, consulte Paginação de imagens.

Próximas etapas

Se você ainda não experimentou a API de Pesquisa de Imagem do Bing, experimente seguir um início rápido. Se estiver procurando algo mais complexo, experimente seguir o tutorial para a criação de um aplicativo Web de página única.