ChatGPT Scraper
Use o actor scraper.chatgpt para capturar respostas do ChatGPT — incluindo a resposta em Markdown, os links de pesquisa e os dados de atribuição — sem precisar fazer engenharia reversa da UI você mesmo.
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.chatgpt",
"input": {
"prompt": "Most reliable proxy service for data extraction",
"country": "JP",
"web_search": true,
"shopping": true
},
"webhook": {
"url": "http://www.youwebhook.com"
}
}'Parâmetros do Corpo
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
prompt | string | Sim | Prompt a ser enviado ao ChatGPT. |
country | string | Sim | Código de país ou região. |
web_search | boolean | Não | Se deve habilitar a pesquisa na web. |
shopping | boolean | Não | Se deve buscar dados de compras. O padrão é true. Quando habilitado, retorna informações de produtos no campo products. |
Campos de Resposta
Nota: Se a resposta incluir dados de compras (o campo
products), 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 múltiplas fontes.
| Parâmetro | Tipo | Descrição |
|---|---|---|
prompt | string | Prompt original. |
result_text | string | Resposta em Markdown do ChatGPT. |
model | string | Identificador do modelo, ex.: gpt-5-1. |
web_search | bool | Indica se o enriquecimento por pesquisa foi executado. |
links | array | Array de links complementares. |
search_result | array | Resultados de SERP associados à resposta. |
search_result.attribution | string | Fonte do resultado de pesquisa. |
search_result.snippet | string | Snippet fornecido pelo ChatGPT. |
search_result.title | string | Título do resultado de pesquisa. |
search_result.url | string | URL do resultado de pesquisa. |
content_references | array | Referências incluídas dentro da resposta do ChatGPT. |
content_references.attribution | string | Fonte da referência. |
content_references.title | string | Título do conteúdo referenciado. |
content_references.url | string | URL do conteúdo referenciado. |
products | array | Informações de produtos retornadas pelo ChatGPT. |
products.id | string | Identificador único do produto. |
products.title | string | Título do produto. |
products.description | string | Descrição do produto (pode ser null). |
products.price | string | Preço exibido, ex.: $799.99. |
products.rating | float | Pontuação média de avaliação. |
products.num_reviews | int | Número de avaliações. |
products.merchants | string | Nomes dos vendedores, ex.: Sony + others. |
products.image_urls | array | Array de URLs de imagens do produto. |
products.url | string | URL da página do produto. |
products.offers | array | Array de ofertas de compra. |
products.offers.merchant_name | string | Nome do vendedor. |
products.offers.price | string | Preço da oferta. |
products.offers.price_details | object | Detalhamento do preço. |
products.offers.price_details.base | string | Preço base. |
products.offers.price_details.total | string | Preço total incluindo impostos e frete. |
products.offers.available | bool | Status de disponibilidade do produto. |
products.offers.details | string | Informações de entrega e estoque. |
products.offers.url | string | URL de checkout ou do produto. |
products.rating_grouped_citation | object | Dados de citação para avaliações. |
products.rating_grouped_citation.title | string | Título da citação. |
products.rating_grouped_citation.url | string | URL da citação. |
products.rating_grouped_citation.supporting_websites | array | Sites que dão suporte à avaliação. |
products.rating_grouped_citation.supporting_websites.title | string | Título do site. |
products.rating_grouped_citation.supporting_websites.url | string | URL do site. |
ads | object | Informações de anúncios retornadas pelo ChatGPT. |
ads.type | string | Tipo da resposta de anúncios, ex.: ads. |
ads.content | object | Conteúdo dos anúncios. |
ads.content.type | string | Tipo da unidade de anúncio, ex.: single_advertiser_ad_unit. |
ads.content.advertiser_brand | object | Informações da marca anunciante. |
ads.content.advertiser_brand.id | string | Identificador único da marca anunciante. |
ads.content.advertiser_brand.name | string | Nome da marca anunciante. |
ads.content.advertiser_brand.url | string | URL do site da marca anunciante. |
ads.content.advertiser_brand.favicon_url | string | URL do ícone favicon do anunciante. |
ads.content.ad_cards | array | Array de cartões de anúncio. |
ads.content.ad_cards.title | string | Título do cartão de anúncio. |
ads.content.ad_cards.body | string | Texto do corpo ou descrição do anúncio. |
ads.content.ad_cards.company_name | string | Nome da empresa anunciante. |
ads.content.ad_cards.format | string | Formato do cartão de anúncio, ex.: image_card_v2. |
ads.content.ad_cards.image_url | string | URL da imagem do anúncio. |
ads.content.ad_cards.cta_product_copy | string | Texto de call-to-action do produto (pode ser null). |
ads.content.ad_cards.card_header | object | Informações do cabeçalho do cartão de anúncio. |
ads.content.ad_cards.card_header.title | string | Título no cabeçalho do cartão. |
ads.content.ad_cards.card_header.subtitle | string | Subtítulo no cabeçalho do cartão, ex.: Sponsored. |
ads.content.ad_cards.card_header.logo_url | string | URL do logo do anunciante. |
ads.content.ad_cards.favicon_url | string | URL do favicon do anúncio. |
ads.content.ad_cards.target | object | Informações do link de destino do anúncio. |
ads.content.ad_cards.target.type | string | Tipo de destino, ex.: url. |
ads.content.ad_cards.target.value | string | O valor real da URL do link de destino. |
ads.content.ad_cards.target.open_externally | bool | Se deve abrir o link externamente. |
ads.content.carousel_cards | array | Array de cartões de anúncio em carrossel. |
ads.content.carousel_cards.title | string | Título do cartão de carrossel. |
ads.content.carousel_cards.body | string | Texto do corpo ou descrição do cartão de carrossel. |
ads.content.carousel_cards.image_url | string | URL da imagem do cartão de carrossel. |
ads.content.carousel_cards.target | object | Informações do link de destino do cartão de carrossel. |
ads.content.carousel_cards.target.type | string | Tipo de destino, ex.: url. |
ads.content.carousel_cards.target.value | string | O valor real da URL do destino do carrossel. |
ads.content.carousel_cards.target.open_externally | bool | Se deve abrir o link do carrossel externamente. |
map | object | Dados de mapa e negócios locais retornados pelo ChatGPT. |
map.entities | array | Lista classificada de entidades resolvidas (ex.: negócios locais). |
map.entities.category | string | Categoria da entidade, ex.: local_business. |
map.entities.id | string | Identificador da entidade (ex.: Google Place ID). |
map.entities.name | string | Nome da entidade. |
map.entities.latitude | float | Latitude da entidade. |
map.entities.longitude | float | Longitude da entidade. |
map.entities.extra_params | object | Parâmetros de busca adicionais para a entidade. |
map.entities.extra_params.address | string | Endereço da entidade. |
map.entities.extra_params.business_id | string | Identificador do negócio. |
map.entities.extra_params.location | string | Contexto de localização da busca. |
map.entities.extra_params.provider | string | Provedor de dados, ex.: yelp-feed, b3. |
map.entities.entity | object | Registro detalhado da entidade. |
map.entities.entity.address | string | Endereço completo. |
map.entities.entity.attributes | object | Atributos adicionais (pode ser null). |
map.entities.entity.categories | array | Rótulos de categoria da entidade. |
map.entities.entity.city | string | Cidade (pode ser null). |
map.entities.entity.country_code | string | Código de país ISO, ex.: US. |
map.entities.entity.country_name | string | Nome do país. |
map.entities.entity.date_closed | string | Data de fechamento (pode ser null). |
map.entities.entity.date_opened | string | Data de abertura (pode ser null). |
map.entities.entity.description | string | Descrição do negócio (pode ser null). |
map.entities.entity.description_cite | string | Citação da descrição (pode ser null). |
map.entities.entity.distance_meters | float | Distância da localização da busca em metros (pode ser null). |
map.entities.entity.enriched_description | string | Descrição enriquecida (pode ser null). |
map.entities.entity.from_cache | bool | Se o registro foi servido a partir do cache. |
map.entities.entity.hours | array | Horário de funcionamento por dia. |
map.entities.entity.hours.day | int | Dia da semana (0=Domingo … 6=Sábado). |
map.entities.entity.hours.start | string | Horário de abertura no formato 24h HHMM, ex.: 0800. |
map.entities.entity.hours.end | string | Horário de fechamento no formato 24h HHMM, ex.: 1900. |
map.entities.entity.id | string | Identificador da entidade. |
map.entities.entity.image_url | string | URL da imagem principal. |
map.entities.entity.image_urls | array | Array de URLs de imagens. |
map.entities.entity.is_claimed | bool | Se a listagem do negócio foi reivindicada (pode ser null). |
map.entities.entity.is_closed_permanently | bool | Se está permanentemente fechado. |
map.entities.entity.is_closed_temporarily | bool | Se está temporariamente fechado. |
map.entities.entity.is_open | bool | Se está atualmente aberto. |
map.entities.entity.latitude | float | Latitude. |
map.entities.entity.location | string | Contexto de localização, ex.: Portland, OR, USA. |
map.entities.entity.longitude | float | Longitude. |
map.entities.entity.menu | object | Informações do cardápio (pode ser null). |
map.entities.entity.menu.url | string | URL do cardápio. |
map.entities.entity.name | string | Nome do negócio. |
map.entities.entity.next_open_hour | object | Próximo horário de abertura. |
map.entities.entity.next_open_hour.day | int | Dia da semana do próximo horário de abertura. |
map.entities.entity.next_open_hour.start | string | Próximo horário de abertura (HHMM). |
map.entities.entity.next_open_hour.end | string | Horário de fechamento correspondente (HHMM). |
map.entities.entity.phone | string | Número de telefone. |
map.entities.entity.popularity_score | float | Pontuação de popularidade (pode ser null). |
map.entities.entity.price | string | Valor do preço (pode ser null). |
map.entities.entity.price_str | string | Indicador de faixa de preço, ex.: $, $$ (pode ser null). |
map.entities.entity.provider | string | Provedor de origem, ex.: yelp-feed, b3, bright-feed. |
map.entities.entity.provider_images | array | Imagens fornecidas pelo provedor (pode ser null). |
map.entities.entity.provider_logo_dark_url | string | URL do logo do provedor para modo escuro (pode ser null). |
map.entities.entity.provider_logo_url | string | URL do logo do provedor (pode ser null). |
map.entities.entity.provider_url | string | URL da entidade no site do provedor. |
map.entities.entity.rank | int | Posição no ranking (pode ser null). |
map.entities.entity.ranking_score | float | Pontuação interna de ranking. |
map.entities.entity.rating | float | Avaliação média. |
map.entities.entity.rating_scale | int | Escala máxima de avaliação, ex.: 5. |
map.entities.entity.reconciled_thumbnails | array | Miniaturas reconciliadas entre provedores. |
map.entities.entity.reconciled_thumbnails.image_url | string | URL da imagem em miniatura. |
map.entities.entity.reconciled_thumbnails.obfuscated_provider | string | Nome ofuscado do provedor da miniatura. |
map.entities.entity.reservation_providers | array | Provedores de reserva disponíveis. |
map.entities.entity.review_count | int | Número de avaliações. |
map.entities.entity.review_highlights | array | Trechos de avaliação em destaque (pode ser null). |
map.entities.entity.reviews | array | Registros de avaliações (pode ser null). |
map.entities.entity.service_providers | array | Provedores de serviço (pode ser null). |
map.entities.entity.special_hours | array | Horários especiais/feriados (pode ser null). |
map.entities.entity.state | string | Código de estado ou região (pode ser null). |
map.entities.entity.tags | array | Tags de atributos, ex.: recursos de acessibilidade. |
map.entities.entity.website_url | string | URL do site oficial. |
map.entities.entity.yelp_menu_url | string | URL do cardápio no Yelp (pode ser null). |
map.entities.entity.zipcode | string | CEP/código postal (pode ser null). |
map.raw_search_entities | array | Entidades de busca brutas, sem classificação. Cada item compartilha a mesma estrutura de map.entities. |
search_model_queries | object | Consultas de fan-out. |
search_model_queries.queries | array | Array de consultas de fan-out. |