chatgpt template is built to obtain conversational responses from ChatGPT.
Useful Links
- The ChatGPT template uses the Premium Proxy Pool by default.
- Asynchronous integration method is recommended for this template.
- Batch requests are supported.
Input Parameters
Request parameters available for the ChatGPT template:| Parameter | Type | Required | Description |
|---|---|---|---|
target | string | ✅ | Target type must be set to chatgpt. |
prompt | string | ✅ | The prompt sent to ChatGPT. Must be fewer than 4000 characters. |
headless | string | By default, JavaScript rendering is forced, omit parameter in the request. Set to png to receive screenshot response. more information here. | |
search | boolean | Activates ChatGPT’s web search functionality for the prompt when set to true. Default value is false. | |
parse | boolean | Automatically parses results when set to true. Default value is false. | |
geo | string | Set the country to use when submitting the prompt. |
Request Examples
# update 'TOKEN VALUE' with your API KEY
curl --request 'POST' \
--url 'https://data.decodo.com/v1/task' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer TOKEN VALUE' \
--header 'Content-Type: application/json' \
--data '
{
"target": "chatgpt",
"prompt": "What are the top tourist attractions in Paris?",
"parse": true,
"search": true,
"geo": "United States"
}
'
const scrape = async() => {
const response = await fetch("https://data.decodo.com/v1/task", {
method: "POST",
body: JSON.stringify({
"target": "chatgpt",
"prompt": "What are the top tourist attractions in Paris?",
"parse": true,
"search": true,
"geo": "United States"
}),
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer TOKEN" // update with your API KEY
},
}).catch(error => console.log(error));
console.log(await response.json())
}
scrape()
import requests
url = "https://data.decodo.com/v1/task"
payload = {
"target": "chatgpt",
"prompt": "What are the top tourist attractions in Paris?",
"parse": True,
"search": True,
"geo": "United States"
}
headers = {
"accept": "application/json",
"content-type": "application/json",
"authorization": "Bearer Token" # update with your API KEY
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
The response returns a task
id. Once the task status is done, fetch the result with GET https://data.decodo.com/v1/task/{task_id}/results. See Asynchronous Requests for polling and batch examples.Output
Descriptions for fields in the parsed JSONcontent section are provided in the table below. Keep in mind that the number of fields can vary according to the provided prompt.
| Content key | Description |
|---|---|
prompt | The original query submitted in the request. |
raw_response | The raw, unparsed response data captured from ChatGPT (Omitted from the example below). |
response_text | The full response text. |
markdown_text | The full response Markdown as a text. |
markdown_json | The full response Markdown as a JSON. |
citations | A list of citation links, each with its URL, title and corresponding text. Returned when the answer cites sources. |
links | A list of links included in the answer, each with its URL and text. Returned when the answer contains links. |
ads | A list of sponsored cards ChatGPT shows next to the answer, each with title, description, url, image_url and advertiser_info (name, url, image_data). Returned only when ads are shown. |
shopping_products | A list of products ChatGPT shows as shopping cards, each with title, price, price_str, currency, rating and thumbnail. Returned only when the answer includes products. |
Response Example
Returned byGET https://data.decodo.com/v1/task/{task_id}/results:
{
"results": [
{
"content": {
"prompt": "What are the top tourist attractions in Paris?",
"response_text": "Paris has an extraordinary number of sights, but for a first visit , these are the main attractions I’d put on your list. Paris’s official tourism sites highlight many of these as essential first-trip stops. Eiffel Tower 🗼 The city’s signature landmark. Go up for panoramic views, or enjoy the tower from the Champ de Mars and Trocadéro.",
"markdown_text": "Eiffel Tower\\, Louvre Museum\\, Notre\\-Dame Cathedral of Paris\n\nParis has an extraordinary number of sights, but for a **first visit**, these are the main attractions I’d put on your list. Paris’s official tourism sites highlight many of these as essential first-trip stops. ([Paris Je t'aime - Office de Tourisme](https://parisjetaime.com/eng/article/Paris-10-must-sees-a992?utm_source=chatgpt.com))\n\n1. **Eiffel Tower** 🗼 \n The city’s signature landmark. Go up for panoramic views, or enjoy the tower from the Champ de Mars and Trocadéro. ([Visit Paris Region](https://www.visitparisregion.com/en/eiffel-tower?utm_source=chatgpt.com))\n",
"markdown_json": [
{
"children": [
{
"raw": "Eiffel Tower",
"type": "text"
},
{
"raw": ",",
"type": "text"
},
{
"raw": " Louvre Museum",
"type": "text"
},
{
"raw": ",",
"type": "text"
},
{
"raw": " Notre",
"type": "text"
},
{
"raw": "-",
"type": "text"
},
{
"raw": "Dame Cathedral of Paris",
"type": "text"
}
],
"type": "paragraph"
},
{
"type": "blank_line"
},
{
"children": [
{
"raw": "Paris has an extraordinary number of sights, but for a ",
"type": "text"
},
{
"children": [
{
"raw": "first visit",
"type": "text"
}
],
"type": "strong"
},
{
"raw": ", these are the main attractions I’d put on your list. Paris’s official tourism sites highlight many of these as essential first-trip stops. (",
"type": "text"
},
{
"attrs": {
"url": "https://parisjetaime.com/eng/article/Paris-10-must-sees-a992?utm_source=chatgpt.com"
},
"children": [
{
"raw": "Paris Je t'aime - Office de Tourisme",
"type": "text"
}
],
"type": "link"
},
{
"raw": ")",
"type": "text"
}
],
"type": "paragraph"
}
],
"citations": [
{
"text": "Paris Je t'aime - Office de Tourisme",
"title": "12 essential activities in Paris",
"url": "https://parisjetaime.com/eng/article/Paris-10-must-sees-a992?utm_source=chatgpt.com"
},
{
"text": "Visit Paris Region",
"title": "What to do in Paris: 10 must-see sites | VisitParisRegion",
"url": "https://www.visitparisregion.com/en/inspiration/top-experiences/must-see-sites?utm_source=chatgpt.com"
}
],
"links": [
{
"text": "12 essential activities in Paris",
"url": "https://parisjetaime.com/eng/article/Paris-10-must-sees-a992?utm_source=chatgpt.com"
},
{
"text": "Discover the Eiffel Tower, the greatest symbol of Paris!",
"url": "https://parisjetaime.com/eng/article/explore-the-eiffel-tower-a1068?utm_source=chatgpt.com"
}
],
"ads": [
{
"title": "Paris Vacations",
"description": "Compare Paris Vacations. View Options and Reserve Now on Expedia.",
"url": "https://www.expedia.com/Paris.d179898.Destination-Travel-Guides?locale=en_US",
"image_url": "https://images.openai.com/static-rsc-5/1yLvGzc2h53id23IZCpKNvYr...",
"advertiser_info": {
"name": "Expedia",
"url": null,
"image_data": "data:image/webp;base64,UklGRnIIAABXRUJQVlA4WAoAAAAQAAAAfwAAf..."
}
}
],
"parse_status_code": 12000
},
"created_at": "2026-10-01 11:40:51",
"updated_at": "2026-10-01 11:41:34",
"page": 1,
"url": "https://chatgpt.com/uc/6abe46d0-7c14-83ea-b96b-14a160859fe2",
"is_render_forced": false,
"status_code": 200,
"type": "parsed",
"parser_type": "",
"parser_preset": null,
"task_id": "7511389667414036482",
"geo": "United States"
}
]
}
Support
Need help or just want to say hello? Our support is available 24/7.
You can also reach us anytime via email at support@decodo.com.
You can also reach us anytime via email at support@decodo.com.
Feedback
Can’t find what you’re looking for? Request an article!
Have feedback? Share your thoughts on how we can improve.
Have feedback? Share your thoughts on how we can improve.