Scraper de ChatGPT
Utiliza el actor scraper.chatgpt para capturar respuestas de ChatGPT, incluida la respuesta en Markdown, enlaces de búsqueda y datos de atribución, sin necesidad de realizar ingeniería inversa en la interfaz de usuario por tu cuenta.
Ejemplo de solicitud
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 del cuerpo
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
prompt | string | Sí | Prompt o consulta a enviar a ChatGPT. |
country | string | Sí | Código de país o región. |
web_search | boolean | No | Indica si se debe habilitar la búsqueda web. |
shopping | boolean | No | Indica si se deben obtener datos de compras. El valor predeterminado es true. Cuando está habilitado, devuelve información de productos en el campo products. |
should_fetch_share_link | boolean | No | Obtener enlace para compartir. |
Campos de respuesta
Nota: Si la respuesta incluye datos de compras (campo
products), la llamada a la API se cobrará al doble de la tarifa base. Esto se debe a la sobrecarga adicional de recursos necesaria para extraer y procesar información de productos desde múltiples fuentes.
| Parámetro | Tipo | Descripción |
|---|---|---|
prompt | string | Prompt original. |
result_text | string | Respuesta en Markdown de ChatGPT. |
model | string | Identificador del modelo, p. ej., gpt-5-1. |
web_search | bool | Indica si se ejecutó el enriquecimiento de búsqueda. |
links | array | Matriz de enlaces complementarios. |
search_result | array | Resultados SERP asociados con la respuesta. |
search_result.attribution | string | Fuente del resultado de búsqueda. |
search_result.snippet | string | Fragmento proporcionado por ChatGPT. |
search_result.title | string | Título del resultado de búsqueda. |
search_result.url | string | URL del resultado de búsqueda. |
content_references | array | Referencias incluidas dentro de la respuesta de ChatGPT. |
content_references.attribution | string | Fuente de la referencia. |
content_references.title | string | Título del contenido referenciado. |
content_references.url | string | URL del contenido referenciado. |
products | array | Información de productos devuelta por ChatGPT. |
products.id | string | Identificador único del producto. |
products.title | string | Título del producto. |
products.description | string | Descripción del producto (puede ser null). |
products.price | string | Precio mostrado, p. ej., $799.99. |
products.rating | float | Puntuación media de valoración. |
products.num_reviews | int | Número de reseñas. |
products.merchants | string | Nombres de los comerciantes, p. ej., Sony + otros. |
products.image_urls | array | Matriz de URL de imágenes del producto. |
products.url | string | URL de la página del producto. |
products.offers | array | Matriz de ofertas de compra. |
products.offers.merchant_name | string | Nombre del comerciante. |
products.offers.price | string | Precio de la oferta. |
products.offers.price_details | object | Desglose detallado del precio. |
products.offers.price_details.base | string | Precio base. |
products.offers.price_details.total | string | Precio total incluidos impuestos y envío. |
products.offers.available | bool | Estado de disponibilidad del producto. |
products.offers.details | string | Información de entrega y stock. |
products.offers.url | string | URL de pago o del producto. |
products.rating_grouped_citation | object | Datos de citación para las valoraciones. |
products.rating_grouped_citation.title | string | Título de la citación. |
products.rating_grouped_citation.url | string | URL de la citación. |
products.rating_grouped_citation.supporting_websites | array | Sitios web que respaldan la valoración. |
products.rating_grouped_citation.supporting_websites.title | string | Título del sitio web. |
products.rating_grouped_citation.supporting_websites.url | string | URL del sitio web. |
ads | object | Información de anuncios devuelta por ChatGPT. |
ads.type | string | Tipo de respuesta de anuncios, p. ej., ads. |
ads.content | object | Contenido de los anuncios. |
ads.content.type | string | Tipo de unidad publicitaria, p. ej., single_advertiser_ad_unit. |
ads.content.advertiser_brand | object | Información de la marca del anunciante. |
ads.content.advertiser_brand.id | string | Identificador único de la marca del anunciante. |
ads.content.advertiser_brand.name | string | Nombre de la marca del anunciante. |
ads.content.advertiser_brand.url | string | URL del sitio web de la marca del anunciante. |
ads.content.advertiser_brand.favicon_url | string | URL del icono favicon del anunciante. |
ads.content.ad_cards | array | Matriz de tarjetas publicitarias. |
ads.content.ad_cards.title | string | Título de la tarjeta publicitaria. |
ads.content.ad_cards.body | string | Texto principal o descripción del anuncio. |
ads.content.ad_cards.company_name | string | Nombre de la empresa anunciante. |
ads.content.ad_cards.format | string | Formato de la tarjeta publicitaria, p. ej., image_card_v2. |
ads.content.ad_cards.image_url | string | URL de la imagen del anuncio. |
ads.content.ad_cards.cta_product_copy | string | Texto de llamada a la acción del producto (puede ser null). |
ads.content.ad_cards.card_header | object | Información del encabezado de la tarjeta publicitaria. |
ads.content.ad_cards.card_header.title | string | Título en el encabezado de la tarjeta. |
ads.content.ad_cards.card_header.subtitle | string | Subtítulo en el encabezado de la tarjeta, p. ej., Sponsored. |
ads.content.ad_cards.card_header.logo_url | string | URL del logotipo del anunciante. |
ads.content.ad_cards.favicon_url | string | URL del favicon del anuncio. |
ads.content.ad_cards.target | object | Información del enlace de destino del anuncio. |
ads.content.ad_cards.target.type | string | Tipo de destino, p. ej., url. |
ads.content.ad_cards.target.value | string | Valor de URL real del enlace de destino. |
ads.content.ad_cards.target.open_externally | bool | Indica si el enlace debe abrirse externamente. |
ads.content.carousel_cards | array | Matriz de tarjetas publicitarias de carrusel. |
ads.content.carousel_cards.title | string | Título de la tarjeta del carrusel. |
ads.content.carousel_cards.body | string | Texto principal o descripción de la tarjeta del carrusel. |
ads.content.carousel_cards.image_url | string | URL de la imagen de la tarjeta del carrusel. |
ads.content.carousel_cards.target | object | Información del enlace de destino de la tarjeta del carrusel. |
ads.content.carousel_cards.target.type | string | Tipo de destino, p. ej., url. |
ads.content.carousel_cards.target.value | string | Valor de URL real del destino del carrusel. |
ads.content.carousel_cards.target.open_externally | bool | Indica si el enlace del carrusel debe abrirse externamente. |
map | object | Datos de mapas y negocios locales devueltos por ChatGPT. |
map.entities | array | Lista ordenada de entidades resueltas (p. ej., negocios locales). |
map.entities.category | string | Categoría de la entidad, p. ej., local_business. |
map.entities.id | string | Identificador de la entidad (p. ej., Google Place ID). |
map.entities.name | string | Nombre de la entidad. |
map.entities.latitude | float | Latitud de la entidad. |
map.entities.longitude | float | Longitud de la entidad. |
map.entities.extra_params | object | Parámetros adicionales de búsqueda para la entidad. |
map.entities.extra_params.address | string | Dirección de la entidad. |
map.entities.extra_params.business_id | string | Identificador del negocio. |
map.entities.extra_params.location | string | Contexto de ubicación de la búsqueda. |
map.entities.extra_params.provider | string | Proveedor de datos, p. ej., yelp-feed, b3. |
map.entities.entity | object | Registro detallado de la entidad. |
map.entities.entity.address | string | Dirección completa. |
map.entities.entity.attributes | object | Atributos adicionales (puede ser null). |
map.entities.entity.categories | array | Etiquetas de categoría para la entidad. |
map.entities.entity.city | string | Ciudad (puede ser null). |
map.entities.entity.country_code | string | Código ISO del país, p. ej., US. |
map.entities.entity.country_name | string | Nombre del país. |
map.entities.entity.date_closed | string | Fecha de cierre (puede ser null). |
map.entities.entity.date_opened | string | Fecha de apertura (puede ser null). |
map.entities.entity.description | string | Descripción del negocio (puede ser null). |
map.entities.entity.description_cite | string | Citación de la descripción (puede ser null). |
map.entities.entity.distance_meters | float | Distancia desde la ubicación de búsqueda en metros (puede ser null). |
map.entities.entity.enriched_description | string | Descripción enriquecida (puede ser null). |
map.entities.entity.from_cache | bool | Indica si el registro se sirvió desde la caché. |
map.entities.entity.hours | array | Horario de apertura por día. |
map.entities.entity.hours.day | int | Día de la semana (0=domingo … 6=sábado). |
map.entities.entity.hours.start | string | Hora de apertura en formato 24h HHMM, p. ej., 0800. |
map.entities.entity.hours.end | string | Hora de cierre en formato 24h HHMM, p. ej., 1900. |
map.entities.entity.id | string | Identificador de la entidad. |
map.entities.entity.image_url | string | URL de la imagen principal. |
map.entities.entity.image_urls | array | Matriz de URL de imágenes. |
map.entities.entity.is_claimed | bool | Indica si el listado del negocio ha sido reclamado (puede ser null). |
map.entities.entity.is_closed_permanently | bool | Indica si está cerrado permanentemente. |
map.entities.entity.is_closed_temporarily | bool | Indica si está cerrado temporalmente. |
map.entities.entity.is_open | bool | Indica si está abierto actualmente. |
map.entities.entity.latitude | float | Latitud. |
map.entities.entity.location | string | Contexto de ubicación, p. ej., Portland, OR, USA. |
map.entities.entity.longitude | float | Longitud. |
map.entities.entity.menu | object | Información del menú (puede ser null). |
map.entities.entity.menu.url | string | URL del menú. |
map.entities.entity.name | string | Nombre del negocio. |
map.entities.entity.next_open_hour | object | Próximo horario de apertura. |
map.entities.entity.next_open_hour.day | int | Día de la semana para la próxima apertura. |
map.entities.entity.next_open_hour.start | string | Próxima hora de apertura (HHMM). |
map.entities.entity.next_open_hour.end | string | Hora de cierre correspondiente (HHMM). |
map.entities.entity.phone | string | Número de teléfono. |
map.entities.entity.popularity_score | float | Puntuación de popularidad (puede ser null). |
map.entities.entity.price | string | Valor del precio (puede ser null). |
map.entities.entity.price_str | string | Indicador de nivel de precio, p. ej., $, $$ (puede ser null). |
map.entities.entity.provider | string | Proveedor de origen, p. ej., yelp-feed, b3, bright-feed. |
map.entities.entity.provider_images | array | Imágenes proporcionadas por el proveedor (puede ser null). |
map.entities.entity.provider_logo_dark_url | string | URL del logotipo del proveedor para el modo oscuro (puede ser null). |
map.entities.entity.provider_logo_url | string | URL del logotipo del proveedor (puede ser null). |
map.entities.entity.provider_url | string | URL de la entidad en el sitio del proveedor. |
map.entities.entity.rank | int | Posición en el ranking (puede ser null). |
map.entities.entity.ranking_score | float | Puntuación interna de clasificación. |
map.entities.entity.rating | float | Valoración media. |
map.entities.entity.rating_scale | int | Escala máxima de valoración, p. ej., 5. |
map.entities.entity.reconciled_thumbnails | array | Miniaturas unificadas entre proveedores. |
map.entities.entity.reconciled_thumbnails.image_url | string | URL de la imagen en miniatura. |
map.entities.entity.reconciled_thumbnails.obfuscated_provider | string | Nombre ofuscado del proveedor para la miniatura. |
map.entities.entity.reservation_providers | array | Proveedores de reservas disponibles. |
map.entities.entity.review_count | int | Número de reseñas. |
map.entities.entity.review_highlights | array | Fragmentos destacados de reseñas (puede ser null). |
map.entities.entity.reviews | array | Registros de reseñas (puede ser null). |
map.entities.entity.service_providers | array | Proveedores de servicios (puede ser null). |
map.entities.entity.special_hours | array | Horarios especiales/festivos (puede ser null). |
map.entities.entity.state | string | Código de estado o región (puede ser null). |
map.entities.entity.tags | array | Etiquetas de atributos, p. ej., características de accesibilidad. |
map.entities.entity.website_url | string | URL del sitio web oficial. |
map.entities.entity.yelp_menu_url | string | URL del menú de Yelp (puede ser null). |
map.entities.entity.zipcode | string | Código postal (puede ser null). |
map.raw_search_entities | array | Entidades de búsqueda sin procesar y sin clasificar. Cada elemento comparte la misma estructura que map.entities. |
search_model_queries | object | Consultas distribuidas (fan-out). |
search_model_queries.queries | array | Matriz de consultas distribuidas. |
share_url | string | Enlace para compartir. |