Google AI Overview Scraper

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

Exemplo de Requisição

curl 'https://api.scrapeless.com/api/v2/scraper/request' \
--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	Código de país ou região.
`shopping`	boolean	Não	Se deve buscar dados de compras. O padrão é `true`. Quando ativado, a resposta inclui informações extras de produtos no campo `products` — as ofertas dos comerciantes por trás de cada agrupamento de produtos, como URL direta da loja, preço, parcelas, estoque, entrega e devoluções.
`location`	string	Não	Nome canônico de localização do Google para resultados com segmentação geográfica (por exemplo, New York,New York,United States). Consulte a lista de segmentação geográfica do Google para todas as localizações suportadas. Mutuamente exclusivo com uule.
`uule`	string	Não	String UULE do Google pré-codificada para segmentação geográfica precisa. Use isto quando tiver um valor UULE pré-construído em vez de um nome de localização. Mutuamente exclusivo com location.
`should_fetch_share_link`	boolean	Não	Obter link de compartilhamento.

Campos de Resposta

Nota: Quando shopping está ativado e a resposta retorna essas informações extras de produtos, a chamada de API será cobrada a 2x a taxa base. Isso se deve ao custo adicional de recursos necessário para extrair e processar informações de produtos de várias fontes.

💡 Quando o modo overview não é acionado, ambos os campos content e rawtext serão strings vazias.

💡 Para acionar o modo overview, você pode tentar ajustar seu prompt ou garantir que as palavras-chave do seu prompt sejam cobertas pelo Google Overview.

Campo de dados Source: produtos dentro do ai overview

type	product_position	description
product	recommended	produtos recomendados
product	inline_link	produtos de link em linha
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 em formato Markdown. Preenchido apenas quando o modo overview é acionado; caso contrário, será uma string vazia.
`rawtext`	string	Dados originais da resposta. Preenchido apenas quando o modo overview é 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	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	Avaliaçã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	Etiquetas.
`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 card 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 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 slot do anúncio.
`ads.price`	string	Preço.
`ads.orig_price`	string	Preço original.
`ads.seller`	string	Vendedor.
`ads.rating`	string	Avaliaçã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.
`products`	array	Informações de produtos retornadas pelo Google Overview Mode.
`products.thumbnails`	array	Array de URLs de imagens em miniatura do produto.
`products.title`	string	Título do produto.
`products.url`	string	URL da página do produto.
`products.brand`	string	Nome da marca do produto.
`products.reviews`	int	Número de avaliações.
`products.rating`	string	Pontuação média de avaliação.
`products.price_range`	string	Faixa de preço, por exemplo, `$2,499.99`.
`products.stores`	array	Array de ofertas de lojas.
`products.stores.name`	string	Nome da loja.
`products.stores.link`	string	Link do produto na loja.
`products.stores.title`	string	Título do produto na loja.
`products.stores.ratings`	string	Avaliação da loja, por exemplo, `4.3/5`.
`products.stores.extensions`	array	Informações adicionais (estoque, entrega, devoluções).
`products.stores.price`	string	Preço na loja.
`products.stores.delivery_fee`	string	Informações da taxa de entrega.
`products.stores.total_price`	string	Preço total incluindo taxas.
`products.about_the_product`	object	Informações detalhadas do produto.
`products.about_the_product.title`	string	Título da seção.
`products.about_the_product.link`	string	Link da página do produto.
`products.about_the_product.displayed_link`	string	Nome de domínio exibido.
`products.about_the_product.features`	array	Recursos/especificações do produto.
`products.about_the_product.features.title`	string	Nome do recurso.
`products.about_the_product.features.value`	string	Valor do recurso.
`products.about_the_product.description`	string	Descrição do produto.
`products.variants`	array	Opções de variantes do produto.
`products.variants.title`	string	Título da categoria da variante.
`products.variants.items`	array	Lista de opções de variantes.
`products.variants.items.name`	string	Nome da opção de variante.
`products.variants.items.selected`	bool	Se esta variante está selecionada.
`products.variants.items.availability`	bool	Status de disponibilidade da variante.
`products.ratings`	array	Dados de distribuição de avaliações.
`products.ratings.stars`	int	Nível de avaliação por estrelas (1-5).
`products.ratings.amount`	int	Número de avaliações neste nível.
`products.user_reviews`	array	Dados de avaliações de usuários.
`products.user_reviews.text`	string	Conteúdo de texto da avaliação.
`products.user_reviews.source`	string	Plataforma de origem da avaliação.
`products.user_reviews.rating`	int	Pontuação de avaliação do usuário.
`products.user_reviews.date`	string	Data da avaliação.
`products.user_reviews.name`	string	Nome do avaliador.
`products.user_reviews.title`	string	Título da avaliação.
`share_url`	string	Link de compartilhamento.

Google AI Mode Grok