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âmetroTipoObrigatórioDescrição
promptstringSimPrompt enviado ao Google AI Mode.
countrystringSimCódigo do país ou região.
shoppingbooleanNãoIndica se os dados de compras devem ser buscados. O padrão é true. Quando ativado, retorna informações de produtos no campo products.
locationstringNãoNome 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.
uulestringNãoString 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.
urlstringNãoLink 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âmetroTipoDescrição
result_textstringCorpo da resposta.
result_mdstringCorpo da resposta no formato Markdown.
result_htmlstringVersão HTML da resposta.
raw_urlstringURL original do Google AI Mode.
citationsarrayFontes de citação.
citations.snippetstringTrecho do artigo citado.
citations.thumbnailstringImagem de capa do artigo citado.
citations.titlestringTítulo da citação.
citations.urlstringURL da citação.
citations.website_namestringNome do site.
citations.faviconstringFavicon do site.
search_resultarrayResultados de pesquisa opcionais referenciados pelo Google.
search_result.snippetstringTrecho do resultado da pesquisa.
search_result.thumbnailstringImagem de capa do resultado da pesquisa.
search_result.titlestringTítulo do resultado da pesquisa.
search_result.urlstringLink do resultado da pesquisa.
search_result.website_namestringNome do site do resultado da pesquisa.
productsarrayInformações de produtos retornadas pelo Google AI Mode.
products.thumbnailsarrayArray de URLs de imagens em miniatura do produto.
products.titlestringTítulo do produto.
products.urlstringURL da página do produto.
products.brandstringNome da marca do produto.
products.reviewsintNúmero de avaliações.
products.ratingstringPontuação média das avaliações.
products.price_rangestringFaixa de preço, ex.: $2,499.99.
products.storesarrayArray de ofertas de lojas.
products.stores.namestringNome da loja.
products.stores.linkstringLink do produto na loja.
products.stores.titlestringTítulo do produto na loja.
products.stores.ratingsstringAvaliação da loja, ex.: 4.3/5.
products.stores.extensionsarrayInformações adicionais (estoque, entrega, devoluções).
products.stores.pricestringPreço na loja.
products.stores.delivery_feestringInformações sobre taxa de entrega.
products.stores.total_pricestringPreço total incluindo taxas.
products.about_the_productobjectInformações detalhadas do produto.
products.about_the_product.titlestringTítulo da seção.
products.about_the_product.linkstringLink da página do produto.
products.about_the_product.displayed_linkstringNome de domínio exibido.
products.about_the_product.featuresarrayRecursos/especificações do produto.
products.about_the_product.features.titlestringNome do recurso.
products.about_the_product.features.valuestringValor do recurso.
products.about_the_product.descriptionstringDescrição do produto.
products.variantsarrayOpções de variantes do produto.
products.variants.titlestringTítulo da categoria da variante.
products.variants.itemsarrayLista de opções de variantes.
products.variants.items.namestringNome da opção da variante.
products.variants.items.selectedboolIndica se esta variante está selecionada.
products.variants.items.availabilityboolStatus de disponibilidade da variante.
products.ratingsarrayDados de distribuição de avaliações.
products.ratings.starsintNível de avaliação em estrelas (1-5).
products.ratings.amountintNúmero de avaliações neste nível.
products.user_reviewsarrayDados de avaliações de usuários.
products.user_reviews.textstringConteúdo textual da avaliação.
products.user_reviews.sourcestringPlataforma de origem da avaliação.
products.user_reviews.ratingintPontuação da avaliação do usuário.
products.user_reviews.datestringData da avaliação.
products.user_reviews.namestringNome do avaliador.
products.user_reviews.titlestringTítulo da avaliação.