Google AI Mode Scraper

scraper.aimode reflete as respostas do Google AI Mode, incluindo o HTML renderizado, as URLs brutas e dados detalhados de citação, para que você possa auditar como os resultados variam entre localidades.

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.aimode",
    "input": {
      "prompt": "Recommended attractions in New York",
      "country": "US",
      "shopping": true
    },
    "webhook": {
      "url": "http://www.youwebhook.com"
    }
  }'

Parâmetros do corpo

Parameter	Type	Required	Description
`prompt`	string	Sim	Prompt enviado ao Google AI Mode.
`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 habilitado, a resposta inclui informações extras de produtos no campo `products` — as ofertas de comerciantes por trás de cada cluster de produtos, como URL direta da loja, preço, parcelamento, estoque, entrega e devoluções.
`location`	string	Não	Nome de localização canônico do Google para resultados com segmentação geográfica (por exemplo, New York,New York,United States). Consulte a lista de destinos geográficos 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 você tiver um valor UULE pré-construído em vez de um nome de localização. Mutuamente exclusivo com location.
`url`	string	Não	Link de acesso completo do Google AI Mode. Mutuamente exclusivo com todos os outros parâmetros. Se este parâmetro for preenchido, todos os outros parâmetros da requisição não precisam ser passados e serão automaticamente ignorados caso sejam passados.
`should_fetch_share_link`	boolean	Não	Obter link de compartilhamento.

Campos da resposta

Observação: Quando shopping está habilitado e a resposta retorna essas informações extras de produtos, a chamada da API será cobrada a 2x a taxa base. Isso se deve à sobrecarga adicional de recursos necessária para extrair e processar informações de produtos de várias fontes.

Parameter	Type	Description
`result_text`	string	Corpo da resposta.
`result_md`	string	Corpo da resposta em formato Markdown.
`result_html`	string	Versão em HTML da resposta.
`raw_url`	string	URL original do Google AI Mode.
`citations`	array	Fontes de citação.
`citations.snippet`	string	Trecho do artigo citado.
`citations.thumbnail`	string	Imagem de capa do artigo citado.
`citations.title`	string	Título da citação.
`citations.url`	string	URL da citação.
`citations.website_name`	string	Nome do site.
`citations.favicon`	string	Favicon do site.
`search_result`	array	Resultados de busca opcionais referenciados pelo Google.
`search_result.snippet`	string	Trecho do resultado de busca.
`search_result.thumbnail`	string	Imagem de capa do resultado de busca.
`search_result.title`	string	Título do resultado de busca.
`search_result.url`	string	Link do resultado de busca.
`search_result.website_name`	string	Nome do site do resultado de busca.
`products`	array	Informações de produtos retornadas pelo Google AI 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 sobre a 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 de 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 em 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 do 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.

Gemini Google AI Overview