language_c","example":"en"},"force_web_search":{"type":"boolean","required":false,"note":"force AI agent to use web search
optional field
when enabled, the AI model is forced to access and cite current web information;
default value: false;
Note: even if the parameter is set to true, there is no guarantee web sources will be"},"tag":{"type":"string","required":false,"note":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response"}},"note":"the POST body is a JSON array holding exactly one task object with these fields; a live route rejects extra tasks with status 40000 \"You can set only one task at a time\""},"test_request":{"body":[{"language_code":"en","location_code":2840,"keyword":"albert einstein"}],"bodyType":"json"},"capability":"ai-search.chatgpt.scrape","capability_description":"Scrape a live ChatGPT answer page for a keyword","platform":"ai-search","platform_label":"AI Visibility / AEO","score":23.3829,"observed":{"samples":244941,"decided":244304,"ok_rate":0.9994,"p50_ms":23958,"p95_ms":64044,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},{"id":"dataforseo.x.ai-optimization-chat-gpt-llm-responses-live","provider":"dataforseo","provider_display":"DataForSEO","name":"ChatGPT answer to a prompt, live","summary":"Live ChatGPT LLM Responses endpoint allows you to retrieve structured responses from a specific ChatGPT AI model, based on the input parameters.","method":"POST","path":"/ai_optimization/chat_gpt/llm_responses/live","scope":"","tier":"extended","kind":"data","domain":"chatgpt","call_template":"treg call dataforseo.x.ai-optimization-chat-gpt-llm-responses-live --method POST --data '[{\"system_message\":\"communicate as if we are in a business meeting\",\"message_chain\":[{\"role\":\"user\",\"message\":\"Hello, what’s up?\"},{\"role\":\"ai\",\"message\":\"Hello! I’m doing well, thank you. How can I assist you today? Are there any specific topics or projects you’d like to discuss in our meeting?\"}],\"max_output_tokens\":200,\"temperature\":0.3,\"top_p\":0.5,\"model_name\":\"gpt-4.1-mini\",\"web_search\":true,\"web_search_country_iso_code\":\"FR\",\"web_search_city\":\"Paris\",\"user_prompt\":\"provide information on how relevant the amusement park business is in France now\"}]'","cost":{"type":"per_call","value":0.0292488,"currency":"USD","per":1,"unit":"call","reported_charge":{"path":"cost","unit":"usd"},"source":"observed","checked":"2026-07-28","confidence":"verified","usd":0.0292488},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","added":"2026-07-28","docs_url":"","has_example":true,"input":{"bodyType":"json","body":{"user_prompt":{"type":"string","required":false,"note":"prompt for the AI model
required field
the question or task you want to send to the AI model;
you can specify up to 500 characters in the user_prompt field","example":"provide information on how relevant the amusement park business is in France now"},"model_name":{"type":"string","required":false,"note":"name of the AI model
required field
model_nameconsists of the actual model name and version name;
if the basic model name is specified, its latest version will be set by default;
for example, if gpt-4.1 is specified, the gpt-4.1-","example":"gpt-4.1-mini"},"max_output_tokens":{"type":"integer","required":false,"note":"maximum number of tokens in the AI response
optional field
minimum value for reasoning models (e.g., reasoning is true in the Models endpoint): 1024;
minimum valu","example":200},"temperature":{"type":"number","required":false,"note":"randomness of the AI response
optional field
higher values make output more diverse;
lower values make output more focused;
minimum value: 0
maximum value: 2
default value: 0.94
Note: not supported in reasoning mo","example":0.3},"top_p":{"type":"number","required":false,"note":"diversity of the AI response
optional field
controls diversity of the response by limiting token selection;
minimum value: 0
maximum value: 1
default value: 0.92Note: top_p cannot be used together with ","example":0.5},"web_search":{"type":"boolean","required":false,"note":"enable web search
optional field
when enabled, the AI model can access and cite current web information;
default value: false;
Note: refer to the Models endpoint","example":true},"force_web_search":{"type":"boolean","required":false,"note":"force AI agent to use web search
optional field
to enable this parameter, web_search must also be enabled;
when enabled, the AI model is forced to access and cite current web information;
default value: false;
Note: even if the param"},"web_search_country_iso_code":{"type":"string","required":false,"note":"ISO country code of the location
optional field
to enable this parameter, web_search must also be enabled;
when enabled, the AI model will search the web from the country you specify;
Note: not supported in o3-mini, o1-pro,","example":"FR"},"web_search_city":{"type":"string","required":false,"note":"city name of the location
optional field
Note: not supported in o3-mini, o1-pro, o1 models","example":"Paris"},"system_message":{"type":"string","required":false,"note":"instructions for the AI behaviour
optional field
defines the AI's role, tone, or specific behavior
you can specify up to 500 characters in the system_message field","example":"communicate as if we are in a business meeting"},"message_chain":{"type":"array","required":false,"note":"conversation history optional field array of message objects representing previous conversation turns; each object must contain: role string with either user or ai role; message string with message content (max 500 characters); you can specify maximum of 10 message objects in the array; Note: for Pe","example":[{"role":"user","message":"Hello, what’s up?"},{"role":"ai","message":"Hello! I’m doing well, thank you. How can I assist you today? Are there any specific topics or projects you’d like to discuss in our meeting?"}]},"tag":{"type":"string","required":false,"note":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response"}},"note":"POST body is a JSON array that must contain exactly one task object (Live endpoints do not support multi-task arrays). Extra elements return per-task status 40000 \"You can set only one task at a time\" ($0 on the rejected tasks) while HTTP stays 200 — one prompt per call."},"test_request":{"body":[{"system_message":"communicate as if we are in a business meeting","message_chain":[{"role":"user","message":"Hello, what’s up?"},{"role":"ai","message":"Hello! I’m doing well, thank you. How can I assist you today? Are there any specific topics or projects you’d like to discuss in our meeting?"}],"max_output_tokens":200,"temperature":0.3,"top_p":0.5,"model_name":"gpt-4.1-mini","web_search":true,"web_search_country_iso_code":"FR","web_search_city":"Paris","user_prompt":"provide information on how relevant the amusement park business is in France now"}],"bodyType":"json"},"capability":"ai-search.chatgpt.answer","capability_description":"Get a ChatGPT answer","platform":"ai-search","platform_label":"AI Visibility / AEO","score":23.3829,"observed":null},{"id":"dataforseo.x.ai-optimization-chat-gpt-llm-scraper-locations-country","provider":"dataforseo","provider_display":"DataForSEO","name":"ChatGPT search location codes by country","summary":"You will receive the list of locations by this API call.","method":"GET","path":"/ai_optimization/chat_gpt/llm_scraper/locations/{country}","scope":"","tier":"extended","kind":"utility","domain":"ai answers","call_template":"treg call dataforseo.x.ai-optimization-chat-gpt-llm-scraper-locations-country","cost":{"type":"free","value":0,"currency":"USD","unit":"call","reported_charge":{"path":"cost","unit":"usd"},"note":"DataForSEO reports cost 0 for this route on our own account — reference/utility data, not metered","usd":0.0},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-07-28","docs_url":"","has_example":false,"input":null,"test_request":null,"capability":"","capability_description":"","platform":"ai-search","platform_label":"AI Visibility / AEO","score":13.9809,"observed":null}],"hints":["treg catalog get exa.web.answer # params, cost and an example response","treg call exa.web.answer --method POST --data '{\"query\":\"What year was the HNSW algorithm paper published and by whom?\"}' # run it — key injected server-side"]}