DocumentaciónAI ScraperExtractores de datosChatGPT

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ámetroTipoObligatorioDescripción
promptstringSíPrompt o consulta a enviar a ChatGPT.
countrystringSíCódigo de país o región.
web_searchbooleanNoIndica si se debe habilitar la búsqueda web.
shoppingbooleanNoIndica 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_linkbooleanNoObtener 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ámetroTipoDescripción
promptstringPrompt original.
result_textstringRespuesta en Markdown de ChatGPT.
modelstringIdentificador del modelo, p. ej., gpt-5-1.
web_searchboolIndica si se ejecutó el enriquecimiento de búsqueda.
linksarrayMatriz de enlaces complementarios.
search_resultarrayResultados SERP asociados con la respuesta.
search_result.attributionstringFuente del resultado de búsqueda.
search_result.snippetstringFragmento proporcionado por ChatGPT.
search_result.titlestringTítulo del resultado de búsqueda.
search_result.urlstringURL del resultado de búsqueda.
content_referencesarrayReferencias incluidas dentro de la respuesta de ChatGPT.
content_references.attributionstringFuente de la referencia.
content_references.titlestringTítulo del contenido referenciado.
content_references.urlstringURL del contenido referenciado.
productsarrayInformación de productos devuelta por ChatGPT.
products.idstringIdentificador único del producto.
products.titlestringTítulo del producto.
products.descriptionstringDescripción del producto (puede ser null).
products.pricestringPrecio mostrado, p. ej., $799.99.
products.ratingfloatPuntuación media de valoración.
products.num_reviewsintNúmero de reseñas.
products.merchantsstringNombres de los comerciantes, p. ej., Sony + otros.
products.image_urlsarrayMatriz de URL de imágenes del producto.
products.urlstringURL de la página del producto.
products.offersarrayMatriz de ofertas de compra.
products.offers.merchant_namestringNombre del comerciante.
products.offers.pricestringPrecio de la oferta.
products.offers.price_detailsobjectDesglose detallado del precio.
products.offers.price_details.basestringPrecio base.
products.offers.price_details.totalstringPrecio total incluidos impuestos y envío.
products.offers.availableboolEstado de disponibilidad del producto.
products.offers.detailsstringInformación de entrega y stock.
products.offers.urlstringURL de pago o del producto.
products.rating_grouped_citationobjectDatos de citación para las valoraciones.
products.rating_grouped_citation.titlestringTítulo de la citación.
products.rating_grouped_citation.urlstringURL de la citación.
products.rating_grouped_citation.supporting_websitesarraySitios web que respaldan la valoración.
products.rating_grouped_citation.supporting_websites.titlestringTítulo del sitio web.
products.rating_grouped_citation.supporting_websites.urlstringURL del sitio web.
adsobjectInformación de anuncios devuelta por ChatGPT.
ads.typestringTipo de respuesta de anuncios, p. ej., ads.
ads.contentobjectContenido de los anuncios.
ads.content.typestringTipo de unidad publicitaria, p. ej., single_advertiser_ad_unit.
ads.content.advertiser_brandobjectInformación de la marca del anunciante.
ads.content.advertiser_brand.idstringIdentificador único de la marca del anunciante.
ads.content.advertiser_brand.namestringNombre de la marca del anunciante.
ads.content.advertiser_brand.urlstringURL del sitio web de la marca del anunciante.
ads.content.advertiser_brand.favicon_urlstringURL del icono favicon del anunciante.
ads.content.ad_cardsarrayMatriz de tarjetas publicitarias.
ads.content.ad_cards.titlestringTítulo de la tarjeta publicitaria.
ads.content.ad_cards.bodystringTexto principal o descripción del anuncio.
ads.content.ad_cards.company_namestringNombre de la empresa anunciante.
ads.content.ad_cards.formatstringFormato de la tarjeta publicitaria, p. ej., image_card_v2.
ads.content.ad_cards.image_urlstringURL de la imagen del anuncio.
ads.content.ad_cards.cta_product_copystringTexto de llamada a la acción del producto (puede ser null).
ads.content.ad_cards.card_headerobjectInformación del encabezado de la tarjeta publicitaria.
ads.content.ad_cards.card_header.titlestringTítulo en el encabezado de la tarjeta.
ads.content.ad_cards.card_header.subtitlestringSubtítulo en el encabezado de la tarjeta, p. ej., Sponsored.
ads.content.ad_cards.card_header.logo_urlstringURL del logotipo del anunciante.
ads.content.ad_cards.favicon_urlstringURL del favicon del anuncio.
ads.content.ad_cards.targetobjectInformación del enlace de destino del anuncio.
ads.content.ad_cards.target.typestringTipo de destino, p. ej., url.
ads.content.ad_cards.target.valuestringValor de URL real del enlace de destino.
ads.content.ad_cards.target.open_externallyboolIndica si el enlace debe abrirse externamente.
ads.content.carousel_cardsarrayMatriz de tarjetas publicitarias de carrusel.
ads.content.carousel_cards.titlestringTítulo de la tarjeta del carrusel.
ads.content.carousel_cards.bodystringTexto principal o descripción de la tarjeta del carrusel.
ads.content.carousel_cards.image_urlstringURL de la imagen de la tarjeta del carrusel.
ads.content.carousel_cards.targetobjectInformación del enlace de destino de la tarjeta del carrusel.
ads.content.carousel_cards.target.typestringTipo de destino, p. ej., url.
ads.content.carousel_cards.target.valuestringValor de URL real del destino del carrusel.
ads.content.carousel_cards.target.open_externallyboolIndica si el enlace del carrusel debe abrirse externamente.
mapobjectDatos de mapas y negocios locales devueltos por ChatGPT.
map.entitiesarrayLista ordenada de entidades resueltas (p. ej., negocios locales).
map.entities.categorystringCategoría de la entidad, p. ej., local_business.
map.entities.idstringIdentificador de la entidad (p. ej., Google Place ID).
map.entities.namestringNombre de la entidad.
map.entities.latitudefloatLatitud de la entidad.
map.entities.longitudefloatLongitud de la entidad.
map.entities.extra_paramsobjectParámetros adicionales de búsqueda para la entidad.
map.entities.extra_params.addressstringDirección de la entidad.
map.entities.extra_params.business_idstringIdentificador del negocio.
map.entities.extra_params.locationstringContexto de ubicación de la búsqueda.
map.entities.extra_params.providerstringProveedor de datos, p. ej., yelp-feed, b3.
map.entities.entityobjectRegistro detallado de la entidad.
map.entities.entity.addressstringDirección completa.
map.entities.entity.attributesobjectAtributos adicionales (puede ser null).
map.entities.entity.categoriesarrayEtiquetas de categoría para la entidad.
map.entities.entity.citystringCiudad (puede ser null).
map.entities.entity.country_codestringCódigo ISO del país, p. ej., US.
map.entities.entity.country_namestringNombre del país.
map.entities.entity.date_closedstringFecha de cierre (puede ser null).
map.entities.entity.date_openedstringFecha de apertura (puede ser null).
map.entities.entity.descriptionstringDescripción del negocio (puede ser null).
map.entities.entity.description_citestringCitación de la descripción (puede ser null).
map.entities.entity.distance_metersfloatDistancia desde la ubicación de búsqueda en metros (puede ser null).
map.entities.entity.enriched_descriptionstringDescripción enriquecida (puede ser null).
map.entities.entity.from_cacheboolIndica si el registro se sirvió desde la caché.
map.entities.entity.hoursarrayHorario de apertura por día.
map.entities.entity.hours.dayintDía de la semana (0=domingo … 6=sábado).
map.entities.entity.hours.startstringHora de apertura en formato 24h HHMM, p. ej., 0800.
map.entities.entity.hours.endstringHora de cierre en formato 24h HHMM, p. ej., 1900.
map.entities.entity.idstringIdentificador de la entidad.
map.entities.entity.image_urlstringURL de la imagen principal.
map.entities.entity.image_urlsarrayMatriz de URL de imágenes.
map.entities.entity.is_claimedboolIndica si el listado del negocio ha sido reclamado (puede ser null).
map.entities.entity.is_closed_permanentlyboolIndica si está cerrado permanentemente.
map.entities.entity.is_closed_temporarilyboolIndica si está cerrado temporalmente.
map.entities.entity.is_openboolIndica si está abierto actualmente.
map.entities.entity.latitudefloatLatitud.
map.entities.entity.locationstringContexto de ubicación, p. ej., Portland, OR, USA.
map.entities.entity.longitudefloatLongitud.
map.entities.entity.menuobjectInformación del menú (puede ser null).
map.entities.entity.menu.urlstringURL del menú.
map.entities.entity.namestringNombre del negocio.
map.entities.entity.next_open_hourobjectPróximo horario de apertura.
map.entities.entity.next_open_hour.dayintDía de la semana para la próxima apertura.
map.entities.entity.next_open_hour.startstringPróxima hora de apertura (HHMM).
map.entities.entity.next_open_hour.endstringHora de cierre correspondiente (HHMM).
map.entities.entity.phonestringNúmero de teléfono.
map.entities.entity.popularity_scorefloatPuntuación de popularidad (puede ser null).
map.entities.entity.pricestringValor del precio (puede ser null).
map.entities.entity.price_strstringIndicador de nivel de precio, p. ej., $, $$ (puede ser null).
map.entities.entity.providerstringProveedor de origen, p. ej., yelp-feed, b3, bright-feed.
map.entities.entity.provider_imagesarrayImágenes proporcionadas por el proveedor (puede ser null).
map.entities.entity.provider_logo_dark_urlstringURL del logotipo del proveedor para el modo oscuro (puede ser null).
map.entities.entity.provider_logo_urlstringURL del logotipo del proveedor (puede ser null).
map.entities.entity.provider_urlstringURL de la entidad en el sitio del proveedor.
map.entities.entity.rankintPosición en el ranking (puede ser null).
map.entities.entity.ranking_scorefloatPuntuación interna de clasificación.
map.entities.entity.ratingfloatValoración media.
map.entities.entity.rating_scaleintEscala máxima de valoración, p. ej., 5.
map.entities.entity.reconciled_thumbnailsarrayMiniaturas unificadas entre proveedores.
map.entities.entity.reconciled_thumbnails.image_urlstringURL de la imagen en miniatura.
map.entities.entity.reconciled_thumbnails.obfuscated_providerstringNombre ofuscado del proveedor para la miniatura.
map.entities.entity.reservation_providersarrayProveedores de reservas disponibles.
map.entities.entity.review_countintNúmero de reseñas.
map.entities.entity.review_highlightsarrayFragmentos destacados de reseñas (puede ser null).
map.entities.entity.reviewsarrayRegistros de reseñas (puede ser null).
map.entities.entity.service_providersarrayProveedores de servicios (puede ser null).
map.entities.entity.special_hoursarrayHorarios especiales/festivos (puede ser null).
map.entities.entity.statestringCódigo de estado o región (puede ser null).
map.entities.entity.tagsarrayEtiquetas de atributos, p. ej., características de accesibilidad.
map.entities.entity.website_urlstringURL del sitio web oficial.
map.entities.entity.yelp_menu_urlstringURL del menú de Yelp (puede ser null).
map.entities.entity.zipcodestringCódigo postal (puede ser null).
map.raw_search_entitiesarrayEntidades de búsqueda sin procesar y sin clasificar. Cada elemento comparte la misma estructura que map.entities.
search_model_queriesobjectConsultas distribuidas (fan-out).
search_model_queries.queriesarrayMatriz de consultas distribuidas.
share_urlstringEnlace para compartir.