Google AI Overview Scraper

scraper.overview captura respostas abrangentes do Google AI Overview, incluindo dados de produtos enriquecidos, citações, anúncios e fontes da web para ajudar você a analisar resultados de pesquisa em diferentes regiões.

Exemplo de Requisição

curl '{api_host}/api/v2/scraper/execute' \
--header 'Content-Type: application/json' \
--header 'x-api-token: {you_api_key}' \
--data '{
    "actor": "scraper.overview",
    "input": {
        "prompt": "Recommended attractions in New York",
        "country": "US",
        "shopping": true
    },
    "webhook": {
        "url": "http://www.youwebhook.com"
    }
}'

Parâmetros do Corpo

Parâmetro	Tipo	Obrigatório	Descrição
`prompt`	string	Sim	Prompt enviado ao Google AI Overview.
`country`	string	Sim	País ou região.
`shopping`	boolean	Não	Se deve buscar dados de compras. O padrão é `true`. Quando ativado, retorna informações de produtos no campo `products`.

Campos da Resposta

Nota: Se a resposta incluir dados de compras (o campo products), a chamada à API será cobrada a 2x a tarifa base. Isso se deve à sobrecarga adicional de recursos necessária para extrair e processar informações de produtos de várias fontes.

💡 Quando o modo de visão geral não for acionado, os campos content e rawtext serão strings vazias.

💡 Para acionar o modo de visão geral, você pode tentar ajustar seu prompt ou garantir que as palavras-chave no seu prompt sejam cobertas pelo Google Overview.

Campo de dados Source: produtos dentro da visão geral da IA

type	product_position	description
product	recommended	produtos recomendados
product	inline_link	produtos de link inline
product	reference	produtos de referência
ads product	null	produtos de anúncios

Campo de dados Products: produtos patrocinados do Google

Campo de dados Ads: Google Ads (SERP)

Parâmetro	Tipo	Descrição
`content`	string	Corpo da resposta no formato Markdown. Preenchido apenas quando o modo de visão geral é acionado; caso contrário, será uma string vazia.
`rawtext`	string	Dados originais da resposta. Preenchido apenas quando o modo de visão geral é acionado; caso contrário, será uma string vazia.
`metadata`	object	Informações de metadados.
`metadata.rawUrl`	string	URL da página web.
`is_overview_shopping`	boolean	Indica se há dados de compras incorporados.
`products`	array	Dados de produtos.
`products.delivery`	string	Serviço de entrega.
`products.discount`	string	Informações de desconto.
`products.img`	string	URL da imagem do produto.
`products.orig_price`	string	Preço original.
`products.rating`	string	Classificação.
`products.review_count`	string	Número de avaliações.
`products.seller`	string	Vendedor.
`products.url`	string	URL da página de detalhes do produto.
`products.stores`	array	Informações da loja.
`products.stores.delivery_fee`	string	Taxa de entrega.
`products.stores.extensions`	array	Serviços adicionais.
`products.stores.link`	string	Link de redirecionamento do produto.
`products.stores.name`	string	Nome da loja.
`products.stores.price`	string	Preço de venda.
`products.ratings`	string	Avaliações.
`products.tag`	string	Tags.
`products.title`	string	Título do produto.
`products.total_price`	string	Preço total.
`source`	array	Fontes de citação.
`source.favicon`	string	Favicon do site.
`source.snippet`	string	Trecho do artigo citado.
`source.thumbnail`	string	Imagem de capa do artigo citado.
`source.title`	string	Título da citação.
`source.type`	string	Tipo de fonte.
`source.url`	string	URL original da citação.
`source.website_name`	string	Nome do site.
`source.html_index`	int	Indica a posição do cartão de compras do produto recomendado no conteúdo Markdown.
`source.stores`	array	Informações da loja.
`source.stores.delivery_fee`	string	Taxa de entrega.
`source.stores.extensions`	array	Serviços adicionais.
`source.stores.link`	string	Link de redirecionamento do produto.
`source.stores.name`	string	Nome da loja.
`source.stores.price`	string	Preço de venda.
`web_source`	array	Fontes de pesquisa na web.
`web_source.favicon`	string	Favicon do site.
`web_source.snippet`	string	Trecho do artigo citado.
`web_source.thumbnail`	string	Imagem de capa do artigo citado.
`web_source.title`	string	Título da citação.
`web_source.url`	string	URL original da citação.
`web_source.website_name`	string	Nome do site.
`web_source.stores`	array	Informações da loja.
`web_source.stores.delivery_fee`	string	Taxa de entrega.
`web_source.stores.extensions`	array	Serviços adicionais.
`web_source.stores.link`	string	Link de redirecionamento do produto.
`web_source.stores.name`	string	Nome da loja.
`web_source.stores.price`	string	Preço de venda.
`ads`	array	Anúncios.
`ads.section_title`	string	Título da seção.
`ads.type`	string	Tipo.
`ads.title`	string	Título.
`ads.url`	string	URL da página web.
`ads.google_ad_url`	string	Link do anúncio.
`ads.display_url`	string	URL de exibição.
`ads.advertiser`	string	Anunciante.
`ads.description`	string	Descrição.
`ads.tracking_token`	string	Token de rastreamento.
`ads.slot`	string	Número do espaço publicitário.
`ads.price`	string	Preço.
`ads.orig_price`	string	Preço original.
`ads.seller`	string	Vendedor.
`ads.rating`	string	Classificação.
`ads.review_count`	string	Número de avaliações.
`ads.img`	string	URL da imagem do produto.
`ads.site_links`	array	Links do site.
`ads.site_links.title`	string	Título.
`ads.site_links.url`	string	URL da página web.
`ads.site_links.google_ad_url`	string	Link do anúncio.

Modo Google AI Grok