Rastreador do Google AI Mode
scraper.aimode espelha as respostas do Google AI Mode, incluindo o HTML renderizado, URLs brutos e dados detalhados de citações, permitindo que você audite como os resultados variam entre diferentes 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
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
prompt | string | Sim | Prompt enviado ao Google AI Mode. |
country | string | Sim | Código do país ou região. |
shopping | boolean | Não | Indica se os dados de compras devem ser buscados. O padrão é true. Quando ativado, retorna informações de produtos no campo products. |
location | string | Não | Nome canônico da localização do Google para resultados segmentados geograficamente (ex.: New York,New York,United States). Consulte a lista de alvos geográficos do Google para ver 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 este parâmetro quando você já possui 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 enviados e serão automaticamente ignorados se forem passados. |
Campos da Resposta
Nota: Se a resposta incluir dados de compras (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.
| Parâmetro | Tipo | Descrição |
|---|---|---|
result_text | string | Corpo da resposta. |
result_md | string | Corpo da resposta no formato Markdown. |
result_html | string | Versão 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 pesquisa opcionais referenciados pelo Google. |
search_result.snippet | string | Trecho do resultado da pesquisa. |
search_result.thumbnail | string | Imagem de capa do resultado da pesquisa. |
search_result.title | string | Título do resultado da pesquisa. |
search_result.url | string | Link do resultado da pesquisa. |
search_result.website_name | string | Nome do site do resultado da pesquisa. |
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 das avaliações. |
products.price_range | string | Faixa de preço, ex.: $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, ex.: 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 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 da variante. |
products.variants.items.selected | bool | Indica 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 textual da avaliação. |
products.user_reviews.source | string | Plataforma de origem da avaliação. |
products.user_reviews.rating | int | Pontuação da 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. |