Pesquisa de Imagens

O google_search source é projetado para recuperar resultados de pesquisa do Google (SERPs). Esta subpágina apresenta especificamente dados relacionados à Pesquisa de Imagens do Google. Para explorar outros tipos de resultados, leia aqui: Pesquisa na Webarrow-up-right, Pesquisa de Notíciasarrow-up-right.

circle-exclamation
circle-info

Explorar saída dicionário de dados para cada recurso de Image SERP, oferecendo uma breve descrição, captura de tela, trecho de código JSON analisado e uma tabela definindo cada campo analisado. Navegue pelos detalhes usando a navegação do lado direito ou rolando a página para baixo.

Amostras de requisição

Nos exemplos abaixo, fazemos uma solicitação para obter páginas de resultados de pesquisa de Imagens para o termo de busca adidas no google.nl domínio.

udm

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "google_search",
        "domain": "nl",
        "query": "adidas",
        "parse": true,
        "context": [
            {
                "key": "udm",
                "value": "2"
            }
        ]
    }'

tbm

Usamos o método de integração síncrono Realtime em nossos exemplos. Se você quiser usar Proxy Endpoint ou integração assíncrona Push-Pull consulte os métodos de integração da seção.

Valores dos parâmetros da requisição

Genérico

Configuração básica e opções de personalização para raspar resultados da Pesquisa de Imagens do Google.

Parâmetro
Descrição
Valor Padrão

source

Define o scraper.

google_search

query

A palavra-chave ou frase a ser pesquisada.

-

contexto: udm

Para obter resultados da Pesquisa de Imagens, defina o valor para 2. Encontre outros valores aceitos aquiarrow-up-right.

-

contexto: tbm

Para obter resultados da Pesquisa de Imagens, defina o valor para isch. Outros valores aceitos: app, blg, bks, dsc, nws, pts, plcs, rcp, lcl.

-

render

Ativa a renderização JavaScript quando definido como html. Mais info.

-

parse

Retorna dados parseados quando definido como true. Explore a saída dicionário de dados.

false

callback_url

URL para o seu endpoint de callback. Mais info.

-

user_agent_type

Tipo de dispositivo e navegador. A lista completa pode ser encontrada aqui.

desktop

- parâmetro obrigatório

- udm e tbm os parâmetros de contexto não podem ser usados juntos em uma única solicitação de raspagem; por favor selecione um deles. Usar ambos simultaneamente pode levar a conflitos ou comportamento inesperado.

Operadores Avançados de Pesquisa do Google

Ao raspar, pode ser útil combinar operadores avançados de pesquisa do Google com sua query. Isso permite personalizar o escopo da busca, garantindo que os resultados sejam mais relevantes e focados. Explore esses comandos especiais aquiarrow-up-right e aquiarrow-up-right. Veja um exemplo abaixo.

Localização

Adapte os resultados da pesquisa a localizações geográficas, domínios e idiomas específicos.

Parâmetro
Descrição
Valor Padrão

geo_location

A localização geográfica para a qual o resultado deve ser adaptado. Usar este parâmetro corretamente é extremamente importante para obter os dados certos. Para mais informações, leia sobre nossas sugeridas geo_location estruturas de parâmetro aqui.

-

domínio

Localização de domínio para o Google. A lista completa de domínios disponíveis pode ser encontrada aquiarrow-up-right.

com

locale

Accept-Language valor do cabeçalho que altera o idioma da interface web da sua página de pesquisa do Google. Mais info.

-

Paginação

Controles para gerenciar a paginação e recuperação dos resultados de pesquisa.

Parâmetro
Descrição
Valor Padrão

start_page

Número da página inicial.

1

pages

Número de páginas a recuperar.

1

Filtragem

Opções para filtrar e refinar resultados de busca com base em vários critérios.

Parâmetro
Descrição
Valor Padrão

context:safe_search

Safe search. Defina como true para habilitá-lo.

false

context: tbs

tbs parâmetro. Este parâmetro é como um contêiner para parâmetros google mais obscuros, como limitar/ordenar resultados por data, bem como outros filtros, alguns dos quais dependem do tbm parâmetro (por exemplo tbs=app_os:1 só está disponível com tbm value app). Mais informações aquiarrow-up-right.

-

Outros

Configurações avançadas adicionais e controles para requisitos especializados.

Parâmetro
Descrição
Valor Padrão

context: fpstate

Definir o fpstate valor para aig fará o Google carregar mais apps. Este parâmetro só é útil se usado junto com o render parâmetro.

-

context: nfpr

true desativará a autocorreção ortográfica

false

Parâmetros de contexto

Todos os parâmetros de contexto devem ser adicionados ao context array como objetos com key e value pares, por exemplo:

Dados estruturados

A SERP Scraper API é capaz de extrair um objeto HTML ou JSON que contém os resultados de pesquisa do Google, oferecendo dados estruturados sobre vários elementos da página de resultados.

chevron-rightgoogle_search saída estruturada de imagenshashtag
circle-info

Nós somente analisamos resultados de pesquisa de imagens para desktop pesquisas.

Dicionário de dados de saída

Exemplo em HTML

Estrutura JSON

A saída estruturada da Pesquisa de Imagens do Google inclui campos como URL, page, results, entre outros. A tabela abaixo apresenta uma lista detalhada de cada recurso do SERP que parseamos, junto com sua descrição e tipo de dado. A tabela também inclui alguns metadados.

circle-info

O número de itens e campos para um tipo de resultado específico pode variar dependendo da consulta de pesquisa.

Chave (results.images)
Descrição
Tipo

url

A URL da página de pesquisa do Google.

string

results

Um dicionário contendo os resultados da pesquisa.

array

results.organic

Uma lista de resultados não pagos com seus respectivos detalhes.

array

resaults.search_information

Uma lista de detalhes para a consulta de pesquisa submetida.

object

results.suggested_searches

Uma lista de pesquisas sugeridas exibida logo abaixo da consulta de pesquisa original.

array

parse_status_code

O código de status do trabalho de parsing. Você pode ver os códigos de status do parser descritos aquiarrow-up-right.

integer

created_at

O timestamp quando o trabalho de scraping foi criado.

timestamp

updated_at

O timestamp quando o trabalho de scraping foi finalizado.

timestamp

page

Número da página relativo à paginação do SERP do Google.

integer

job_id

O ID do job associado ao trabalho de scraping.

string

status_code

O código de status do trabalho de scraping. Você pode ver os códigos de status do scraper descritos aquiarrow-up-right.

integer

circle-info

Nas seções seguintes, os trechos de código JSON parseado são encurtados quando há mais de um item disponível para o tipo de resultado.

Orgânico

A Pesquisa de Imagens organic a seção mostra listagens não pagas nos resultados da Pesquisa de Imagens do Google, organizadas por relevância pelo algoritmo do Google. Esses resultados são apresentados a usuários que procuram conteúdo visual e são exibidos em uma seção dedicada, distinta de outros tipos de resultados de pesquisa.

Chave (results.organic)
Descrição
Tipo

pos

Um indicador único que denota a posição da imagem na lista.

string

link

A URL do site onde a imagem está colocada.

array

image

A URL da imagem.

array

title

O título do artigo onde a imagem está colocada.

object

domínio

O domínio do site que contém o resultado da imagem.

array

pos_overall

Um indicador único que denota a posição da imagem na lista.

integer

Informações da pesquisa

informações da pesquisa é uma seção que fornece detalhes sobre a consulta de pesquisa. Inclui informações como o termo de pesquisa original e, se aplicável, quaisquer autocorreções feitas pelo Google.

Chave (results.search_information)
Descrição
Tipo

query

O termo de pesquisa original.

string

showing_results_for

O termo de pesquisa pelo qual os resultados estão sendo mostrados. query e showing_results_for pode diferir se o Google autocorrigiu o termo de pesquisa fornecido.

array

Pesquisas sugeridas

O suggested_searches (array) na Pesquisa de Imagens do Google fornece uma lista de termos de pesquisa sugeridos relacionados à consulta original. Os usuários podem explorar essas opções adicionais para refinar ou expandir sua pesquisa de imagens.

Atualizado

Isto foi útil?