ChatGPT Scraper

Use the scraper.chatgpt actor to capture ChatGPT answers—including the Markdown response, search links, and attribution data—without needing to reverse engineer the UI yourself.

Request Example

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"
    }
  }'

Body Parameters

Parameter	Type	Required	Description
`prompt`	string	Yes	Prompt to send to ChatGPT.
`country`	string	Yes	Country or region code.
`web_search`	boolean	No	Whether to enable web search.
`shopping`	boolean	No	Whether to fetch shopping data. Defaults to `true`. When enabled, returns product information in the `products` field.

Response Fields

Note: If the response includes shopping data (the products field), the API call will be charged at 2x the base rate. This is due to the additional resource overhead required for extracting and processing product information from multiple sources.

Parameter	Type	Description
`prompt`	string	Original prompt.
`result_text`	string	Markdown response from ChatGPT.
`model`	string	Model identifier, e.g., `gpt-5-1`.
`web_search`	bool	Indicates whether search enrichment ran.
`links`	array	Array of supplementary links.
`search_result`	array	SERP results associated with the response.
`search_result.attribution`	string	Source of the search result.
`search_result.snippet`	string	Snippet supplied by ChatGPT.
`search_result.title`	string	Title of the search hit.
`search_result.url`	string	URL of the search hit.
`content_references`	array	References included inside the ChatGPT answer.
`content_references.attribution`	string	Source of the reference.
`content_references.title`	string	Title of the referenced content.
`content_references.url`	string	URL of the referenced content.
`products`	array	Product information returned by ChatGPT.
`products.id`	string	Unique product identifier.
`products.title`	string	Product title.
`products.description`	string	Product description (may be null).
`products.price`	string	Display price, e.g., `$799.99`.
`products.rating`	float	Average rating score.
`products.num_reviews`	int	Number of reviews.
`products.merchants`	string	Merchant names, e.g., `Sony + others`.
`products.image_urls`	array	Array of product image URLs.
`products.url`	string	Product page URL.
`products.offers`	array	Array of purchase offers.
`products.offers.merchant_name`	string	Name of the merchant.
`products.offers.price`	string	Offer price.
`products.offers.price_details`	object	Detailed price breakdown.
`products.offers.price_details.base`	string	Base price.
`products.offers.price_details.total`	string	Total price including tax and shipping.
`products.offers.available`	bool	Product availability status.
`products.offers.details`	string	Delivery and stock information.
`products.offers.url`	string	Checkout or product URL.
`products.rating_grouped_citation`	object	Citation data for ratings.
`products.rating_grouped_citation.title`	string	Citation title.
`products.rating_grouped_citation.url`	string	Citation URL.
`products.rating_grouped_citation.supporting_websites`	array	Websites supporting the rating.
`products.rating_grouped_citation.supporting_websites.title`	string	Website title.
`products.rating_grouped_citation.supporting_websites.url`	string	Website URL.
`ads`	object	Ads information returned by ChatGPT.
`ads.type`	string	Type of the ads response, e.g., `ads`.
`ads.content`	object	Content of the ads.
`ads.content.type`	string	Type of ad unit, e.g., `single_advertiser_ad_unit`.
`ads.content.advertiser_brand`	object	Advertiser brand information.
`ads.content.advertiser_brand.id`	string	Unique identifier for the advertiser brand.
`ads.content.advertiser_brand.name`	string	Name of the advertiser brand.
`ads.content.advertiser_brand.url`	string	URL of the advertiser brand website.
`ads.content.advertiser_brand.favicon_url`	string	URL of the advertiser’s favicon icon.
`ads.content.ad_cards`	array	Array of advertisement cards.
`ads.content.ad_cards.title`	string	Title of the advertisement card.
`ads.content.ad_cards.body`	string	Body text or description of the ad.
`ads.content.ad_cards.company_name`	string	Name of the advertising company.
`ads.content.ad_cards.format`	string	Format of the ad card, e.g., `image_card_v2`.
`ads.content.ad_cards.image_url`	string	URL of the advertisement image.
`ads.content.ad_cards.cta_product_copy`	string	Call-to-action product copy (may be null).
`ads.content.ad_cards.card_header`	object	Header information of the ad card.
`ads.content.ad_cards.card_header.title`	string	Title in the card header.
`ads.content.ad_cards.card_header.subtitle`	string	Subtitle in the card header, e.g., `Sponsored`.
`ads.content.ad_cards.card_header.logo_url`	string	URL of the advertiser’s logo.
`ads.content.ad_cards.favicon_url`	string	URL of the favicon for the ad.
`ads.content.ad_cards.target`	object	Target link information for the ad.
`ads.content.ad_cards.target.type`	string	Type of target, e.g., `url`.
`ads.content.ad_cards.target.value`	string	The actual URL value of the target link.
`ads.content.ad_cards.target.open_externally`	bool	Whether to open the link externally.
`ads.content.carousel_cards`	array	Array of carousel advertisement cards.
`ads.content.carousel_cards.title`	string	Title of the carousel card.
`ads.content.carousel_cards.body`	string	Body text or description of the carousel card.
`ads.content.carousel_cards.image_url`	string	URL of the carousel card image.
`ads.content.carousel_cards.target`	object	Target link information for the carousel card.
`ads.content.carousel_cards.target.type`	string	Type of target, e.g., `url`.
`ads.content.carousel_cards.target.value`	string	The actual URL value of the carousel target.
`ads.content.carousel_cards.target.open_externally`	bool	Whether to open the carousel link externally.
`map`	object	Map and local business data returned by ChatGPT.
`map.entities`	array	Ranked list of resolved entities (e.g., local businesses).
`map.entities.category`	string	Entity category, e.g., `local_business`.
`map.entities.id`	string	Entity identifier (e.g., Google Place ID).
`map.entities.name`	string	Entity name.
`map.entities.latitude`	float	Entity latitude.
`map.entities.longitude`	float	Entity longitude.
`map.entities.extra_params`	object	Additional lookup parameters for the entity.
`map.entities.extra_params.address`	string	Entity address.
`map.entities.extra_params.business_id`	string	Business identifier.
`map.entities.extra_params.location`	string	Search location context.
`map.entities.extra_params.provider`	string	Data provider, e.g., `yelp-feed`, `b3`.
`map.entities.entity`	object	Detailed entity record.
`map.entities.entity.address`	string	Full street address.
`map.entities.entity.attributes`	object	Additional attributes (may be null).
`map.entities.entity.categories`	array	Category labels for the entity.
`map.entities.entity.city`	string	City (may be null).
`map.entities.entity.country_code`	string	ISO country code, e.g., `US`.
`map.entities.entity.country_name`	string	Country name.
`map.entities.entity.date_closed`	string	Date closed (may be null).
`map.entities.entity.date_opened`	string	Date opened (may be null).
`map.entities.entity.description`	string	Business description (may be null).
`map.entities.entity.description_cite`	string	Description citation (may be null).
`map.entities.entity.distance_meters`	float	Distance from the search location in meters (may be null).
`map.entities.entity.enriched_description`	string	Enriched description (may be null).
`map.entities.entity.from_cache`	bool	Whether the record was served from cache.
`map.entities.entity.hours`	array	Opening hours per day.
`map.entities.entity.hours.day`	int	Day of week (0=Sunday … 6=Saturday).
`map.entities.entity.hours.start`	string	Opening time in 24h `HHMM` format, e.g., `0800`.
`map.entities.entity.hours.end`	string	Closing time in 24h `HHMM` format, e.g., `1900`.
`map.entities.entity.id`	string	Entity identifier.
`map.entities.entity.image_url`	string	Primary image URL.
`map.entities.entity.image_urls`	array	Array of image URLs.
`map.entities.entity.is_claimed`	bool	Whether the business listing is claimed (may be null).
`map.entities.entity.is_closed_permanently`	bool	Whether permanently closed.
`map.entities.entity.is_closed_temporarily`	bool	Whether temporarily closed.
`map.entities.entity.is_open`	bool	Whether currently open.
`map.entities.entity.latitude`	float	Latitude.
`map.entities.entity.location`	string	Location context, e.g., `Portland, OR, USA`.
`map.entities.entity.longitude`	float	Longitude.
`map.entities.entity.menu`	object	Menu information (may be null).
`map.entities.entity.menu.url`	string	Menu URL.
`map.entities.entity.name`	string	Business name.
`map.entities.entity.next_open_hour`	object	Next opening slot.
`map.entities.entity.next_open_hour.day`	int	Day of week for the next opening.
`map.entities.entity.next_open_hour.start`	string	Next opening time (`HHMM`).
`map.entities.entity.next_open_hour.end`	string	Corresponding closing time (`HHMM`).
`map.entities.entity.phone`	string	Phone number.
`map.entities.entity.popularity_score`	float	Popularity score (may be null).
`map.entities.entity.price`	string	Price value (may be null).
`map.entities.entity.price_str`	string	Price level indicator, e.g., `$`, `$$` (may be null).
`map.entities.entity.provider`	string	Source provider, e.g., `yelp-feed`, `b3`, `bright-feed`.
`map.entities.entity.provider_images`	array	Provider-supplied images (may be null).
`map.entities.entity.provider_logo_dark_url`	string	Provider logo URL for dark mode (may be null).
`map.entities.entity.provider_logo_url`	string	Provider logo URL (may be null).
`map.entities.entity.provider_url`	string	URL of the entity on the provider site.
`map.entities.entity.rank`	int	Rank position (may be null).
`map.entities.entity.ranking_score`	float	Internal ranking score.
`map.entities.entity.rating`	float	Average rating.
`map.entities.entity.rating_scale`	int	Maximum rating scale, e.g., `5`.
`map.entities.entity.reconciled_thumbnails`	array	Thumbnails reconciled across providers.
`map.entities.entity.reconciled_thumbnails.image_url`	string	Thumbnail image URL.
`map.entities.entity.reconciled_thumbnails.obfuscated_provider`	string	Obfuscated provider name for the thumbnail.
`map.entities.entity.reservation_providers`	array	Reservation providers available.
`map.entities.entity.review_count`	int	Number of reviews.
`map.entities.entity.review_highlights`	array	Highlighted review snippets (may be null).
`map.entities.entity.reviews`	array	Review records (may be null).
`map.entities.entity.service_providers`	array	Service providers (may be null).
`map.entities.entity.special_hours`	array	Special/holiday hours (may be null).
`map.entities.entity.state`	string	State or region code (may be null).
`map.entities.entity.tags`	array	Attribute tags, e.g., accessibility features.
`map.entities.entity.website_url`	string	Official website URL.
`map.entities.entity.yelp_menu_url`	string	Yelp menu URL (may be null).
`map.entities.entity.zipcode`	string	ZIP/postal code (may be null).
`map.raw_search_entities`	array	Raw, unranked search entities. Each item shares the same structure as `map.entities`.

Task Lifecycle Perplexity