---
title: "Live ChatGPT LLM Scraper Advanced"
url: "https://docs.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/live/advanced/"
date: "2026-06-06"
---
## Live ChatGPT LLM Scraper Advanced
Live ChatGPT LLM Scraper endpoint provides results from ChatGPT searches. The results are specific to the selected location (see [the List of Locations](https://docs.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations.md)) and language (see [the List of Languages](https://docs.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languages.md)) parameters.
 POST https://api.dataforseo.com/v3/ai\_optimization/chat\_gpt/llm\_scraper/live/advanced
Pricing
The cost of the task can be calculated on the [Pricing page](https://dataforseo.com/pricing/ai-optimization/llm-scraper).
All POST data should be sent in the [JSON](https://en.wikipedia.org/wiki/JSON) format (UTF-8 encoding). The task setting is done using the POST method. When setting a task, you should send all task parameters in the task array of the generic POST array. You can send up to 2000 API calls per minute, each Live ChatGPT LLM Scraper API call can contain only one task.
**Execution time for tasks set with the Live ChatGPT LLM Scraper endpoint is currently up to 120 seconds.**
Below you will find a detailed description of the fields you can use for setting a task.
| Field name | Type | Description |
|---|---|---|
| `keyword` | string | *keyword* **required field** you can specify **up to 2000 characters** in the `keyword` field all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your `keyword`, please specify it as “%25”; if you need to use the “+” character for your `keyword`, please specify it as “%2B” learn more about rules and limitations of `keyword` and `keywords` fields in DataForSEO APIs in this [Help Center article](https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis) |
| `location_name` | string | *full name of search engine location* **required field if you don't specify** `location_code` **if you use this field, you don't need to specify `location_code`** you can receive the list of available locations of the search engine with their `location_name` by making a separate request to the `https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations` example: `United States` |
| `location_code` | integer | *search engine location code* **required field if you don't specify** `location_name` **if you use this field, you don't need to specify `location_name`** you can receive the list of available locations of the search engines with their `location_code` by making a separate request to the `https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations` example: `2840` |
| `language_name` | string | *full name of search engine language* **required field if you don't specify `language_code`;** if you use this field, you don't need to specify `language_code`; you can receive the list of available languages of the search engine with their `language_name` by making a separate request to the `https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languages` |
| `language_code` | string | *search engine language code* **required field if you don't specify `language_name`;** if you use this field, you don't need to specify `language_name`; you can receive the list of available languages of the search engine with their `language_code` by making a separate request to the `https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languages` |
| `force_web_search` | boolean | *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 cited in the response |
| `tag` | string | *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 |
As a response of the API server, you will receive [JSON](https://en.wikipedia.org/wiki/JSON)-encoded data containing a `tasks` array with the information specific to the set tasks.
**Description of the fields in the results array:**
| Field name | Type | Description |
|---|---|---|
| `version` | string | *the current version of the API* |
| `status_code` | integer | *general status code* you can find the full list of the response codes [here](https://docs.dataforseo.com/v3/appendix/errors.md) **Note:** we strongly recommend designing a necessary system for handling related exceptional or error conditions |
| `status_message` | string | *general informational message* you can find the full list of general informational messages [here](https://docs.dataforseo.com/v3/appendix/errors.md) |
| `time` | string | *execution time, seconds* |
| `cost` | float | *total tasks cost, USD* |
| `tasks_count` | integer | *the number of tasks in the **`tasks`** array* |
| `tasks_error` | integer | *the number of tasks in the **`tasks`** array returned with an error* |
| **`tasks`** | array | *array of tasks* |
| `id` | string | *task identifier* **unique task identifier in our system in the [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format** |
| `status_code` | integer | *status code of the task* generated by DataForSEO; can be within the following range: 10000-60000 you can find the full list of the response codes [here](https://docs.dataforseo.com/v3/appendix/errors.md) |
| `status_message` | string | *informational message of the task* you can find the full list of general informational messages [here](https://docs.dataforseo.com/v3/appendix/errors.md) |
| `time` | string | *execution time, seconds* |
| `cost` | float | *cost of the task, USD* |
| `result_count` | integer | *number of elements in the `result` array* |
| `path` | array | *URL path* |
| `data` | object | *contains the same parameters that you specified in the POST request* |
| **`result`** | array | *array of results* |
| `keyword` | string | *keyword received in a POST array* **the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)** |
| `location_code` | integer | *location code in a POST array* |
| `language_code` | string | *language code in a POST array* |
| `model` | string | *indicates the model version* |
| `check_url` | string | *direct URL to search engine results* you can use it to make sure that we provided exact results |
| `datetime` | string | *date and time when the result was received* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2019-11-15 12:57:46 +00:00` |
| `markdown` | string | *content of the element in markdown format* content of the result formatted in the [markdown markup language](https://en.wikipedia.org/wiki/Markdown) |
| **`search_results`** | array | *array of search results* all web search outputs the model retrieved when looking up information, including duplicates and unused entries |
| `type` | string | *type of element*=***'chatgpt\_search\_result'***n |
| `url` | string | *result URL* |
| `domain` | string | *result domain* |
| `title` | string | *result title* |
| `description` | string | *result description* |
| `breadcrumb` | string | *breadcrumb* |
| **`sources`** | array | *array of sources* the sources the model actually cited or relied on in its final answer |
| `type` | string | *type of element*=***'chat\_gpt\_source'*** |
| `title` | string | *source title* |
| `snippet` | string | *source description* |
| `domain` | string | *source domain* |
| `url` | string | *source URL* |
| `thumbnail` | string | *source thumbnail* |
| `source_name` | string | *source name* |
| `publication_date` | string | *date and time when the result was published* in the format: “year-month-date:minutes:UTC\_difference\_hours:UTC\_difference\_minutes” example: `2019-11-15 12:57:46 +00:00` |
| `markdown` | string | *content of the element in markdown format* content of the result formatted in the [markdown markup language](https://en.wikipedia.org/wiki/Markdown) |
| `fan_out_queries` | array | *array of fan-out queries* contains related search queries derived from the main query to provide a more comprehensive response |
| **`brand_entities`** | array | *array of brand entities* contains information on brands mentioned in the response |
| `type` | string | *type of the element = **'chat\_gpt\_brand\_entity'*** |
| `title` | string | *name of the brand* |
| `category` | string | *category of the brand* |
| `markdown` | string | *brand name in markdown format* contains brand name formatted in the [markdown markup language](https://en.wikipedia.org/wiki/Markdown) |
| **`urls`** | array | *array of URLs and domains relevant to the brand* |
| `url` | string | *URL* |
| `domain` | string | *domain* |
| `se_results_count` | integer | *total number of results* |
| `item_types` | array | *types of search results* contains types of search results (`items`) found in SERP. possible item types: `chat_gpt_text`, `chat_gpt_table`, `chat_gpt_navigation_list`, `chat_gpt_images`, `chat_gpt_local_businesses`, `chat_gpt_products` |
| `items_count` | integer | *the number of results returned in the **`items`** array* |
| **`items`** | array | *elements of ChatGPT results* |
| **`chat_gpt_text`** | object | *element in the response* |
| `type` | string | *type of element*=***'chat\_gpt\_text'*** |
| `rank_group` | integer | *group rank in SERP* position within a group of elements with identical `type` values positions of elements with different `type` values are omitted from `rank_group` |
| `rank_absolute` | integer | *absolute rank in SERP* absolute position among all the elements in SERP |
| `markdown` | string | *content of the element in markdown format* content of the result formatted in the [markdown markup language](https://en.wikipedia.org/wiki/Markdown) |
| **`sources`** | array | *array of sources* |
| `type` | string | *type of element*=***'chat\_gpt\_source'***n |
| `title` | string | *source title* |
| `snippet` | string | *source description* |
| `domain` | string | *source domain in SERP* |
| `url` | string | *source URL* |
| `thumbnail` | string | *source thumbnail* |
| `source_name` | string | *source name* |
| `publication_date` | string | *date and time when the result was published* in the format: “year-month-date:minutes:UTC\_difference\_hours:UTC\_difference\_minutes” example: `2019-11-15 12:57:46 +00:00` |
| `markdown` | string | *content of the element in markdown format* content of the result formatted in the [markdown markup language](https://en.wikipedia.org/wiki/Markdown) |
| **`brand_entities`** | array | *array of brand entities* contains information on brands mentioned in the text |
| `type` | string | *type of the element = **'chat\_gpt\_brand\_entity'*** |
| `title` | string | *name of the brand* |
| `category` | string | *category of the brand* |
| `markdown` | string | *brand name in markdown format* contains brand name formatted in the [markdown markup language](https://en.wikipedia.org/wiki/Markdown) |
| **`urls`** | array | *array of URLs and domains relevant to the brand* |
| `url` | string | *URL* |
| `domain` | string | *domain* |
| **`chat_gpt_table`** | object | *element in the response* |
| `type` | string | *type of element*=***'chat\_gpt\_table'*** |
| `rank_group` | integer | *group rank in SERP* position within a group of elements with identical `type` values positions of elements with different `type` values are omitted from `rank_group` |
| `rank_absolute` | integer | *absolute rank in SERP* absolute position among all the elements in SERP |
| `text` | string | *text of the element* |
| `markdown` | string | *content of the element in markdown format* content of the result formatted in the [markdown markup language](https://en.wikipedia.org/wiki/Markdown) |
| **`table`** | object | *table present in the element* the header and content of the table present in the element |
| `table_header` | array | *content in the header of the table* |
| `table_content` | array | *array of contents of the table present in the element* each array represents the table row |
| **`brand_entities`** | array | *array of brand entities* contains information on brands mentioned in the table |
| `type` | string | *type of the element = **'chat\_gpt\_brand\_entity'*** |
| `title` | string | *name of the brand* |
| `category` | string | *category of the brand* |
| `markdown` | string | *brand name in markdown format* contains brand name formatted in the [markdown markup language](https://en.wikipedia.org/wiki/Markdown) |
| **`urls`** | array | *array of URLs and domains relevant to the brand* |
| `url` | string | *URL* |
| `domain` | string | *domain* |
| **`chat_gpt_navigation_list`** | object | *element in the response* |
| `type` | string | *type of element*=***'chat\_gpt\_navigation\_list'*** |
| `rank_group` | integer | *group rank in SERP* position within a group of elements with identical `type` values positions of elements with different `type` values are omitted from `rank_group` |
| `rank_absolute` | integer | *absolute rank in SERP* absolute position among all the elements in SERP |
| `title` | string | *title of the element* |
| **`sources`** | array | *array of sources* |
| `type` | string | *type of element*=***'chat\_gpt\_source'*** |
| `title` | string | *source title* |
| `snippet` | string | *source description* |
| `domain` | string | *source domain in SERP* |
| `url` | string | *source URL* |
| `thumbnail` | string | *source thumbnail* |
| `source_name` | string | *source name* |
| `publication_date` | string | *date and time when the result was published* in the format: “year-month-date:minutes:UTC\_difference\_hours:UTC\_difference\_minutes” example: `2019-11-15 12:57:46 +00:00` |
| `markdown` | string | *content of the element in markdown format* content of the result formatted in the [markdown markup language](https://en.wikipedia.org/wiki/Markdown) |
| **`chat_gpt_images`** | object | *element in the response* |
| `type` | string | *type of element*=***'chat\_gpt\_images'*** |
| `rank_group` | integer | *group rank in SERP* position within a group of elements with identical `type` values positions of elements with different `type` values are omitted from `rank_group` |
| `rank_absolute` | integer | *absolute rank in SERP* absolute position among all the elements in SERP |
| `markdown` | string | *content of the element in markdown format* content of the result formatted in the [markdown markup language](https://en.wikipedia.org/wiki/Markdown) |
| **`items`** | array | *items present in the element* |
| `type` | string | *type of element = '**chat\_gpt\_images\_element**'* |
| `alt` | string | *alt tag of the image* |
| `url` | string | *relevant URL* |
| `image_url` | string | *URL of the image* the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available) |
| `markdown` | string | *content of the element in markdown format* content of the result formatted in the [markdown markup language](https://en.wikipedia.org/wiki/Markdown) |
| **`chat_gpt_local_businesses`** | object | *element in the response* |
| `type` | string | *type of element*=***'chat\_gpt\_local\_businesses'*** |
| `rank_group` | integer | *group rank in SERP* position within a group of elements with identical `type` values positions of elements with different `type` values are omitted from `rank_group` |
| `rank_absolute` | integer | *absolute rank in SERP* absolute position among all the elements in SERP |
| `markdown` | string | *content of the element in markdown format* content of the result formatted in the [markdown markup language](https://en.wikipedia.org/wiki/Markdown) |
| **`items`** | array | *items present in the element* |
| `type` | string | *type of element = '**chat\_gpt\_local\_businesses\_element**'* |
| `title` | string | *title of the local business* |
| `description` | string | *description of the local business* |
| `address` | string | *address of the local business* |
| `phone` | string | *phone of the local business* |
| `reviews_count` | integer | *total number of reviews submitted for the local business* |
| `url` | string | *website URL of the local business* |
| `domain` | string | *domain name of the local business* |
| **`rating`** | object | *rating of the corresponding local business* popularity rate based on reviews and displayed in SERP |
| `rating_type` | string | *type of rating* here you can find the following elements: `Max5`, `Percents`, `CustomMax` |
| `value` | float | *the average rating based on all reviews* |
| `votes_count` | integer | *the number of votes* |
| `rating_max` | integer | *the maximum value for a `rating_type`* |
| **`chat_gpt_products`** | object | *element in the response* |
| `type` | string | *type of element*=***'chat\_gpt\_products'*** |
| `rank_group` | integer | *group rank in SERP* position within a group of elements with identical `type` values positions of elements with different `type` values are omitted from `rank_group` |
| `rank_absolute` | integer | *absolute rank in SERP* absolute position among all the elements in SERP |
| **`items`** | array | *items present in the element* |
| `type` | string | *type of element = '**chat\_gpt\_products\_element**'* |
| `product_id` | string | *product id* |
| `merchants` | string | *merchant(s) offering the product* |
| `id_to_token_map` | string | *product identifier token* Base64-encoded token containing Google Shopping product IDs associated with the product |
| `title` | string | *title of the product* |
| **`rating`** | object | *rating of the product* popularity rate based on reviews and displayed in SERP |
| `rating_type` | string | *type of rating* here you can find the following elements: `Max5`, `Percents`, `CustomMax` |
| `value` | float | *the average rating based on all reviews* |
| `votes_count` | integer | *the number of votes* |
| `rating_max` | integer | *the maximum value for a `rating_type`* |
| `price` | float | *product price* |
| `currency` | string | *currency of the listed price* ISO code of the currency applied to the price |
| `tag` | string | *tag text* |
| `url` | string | *result URL* |
| `domain` | string | *result domain in SERP* |
| `images` | array | *image URLs of the element* contains URLs leading to the images on the original resource or DataForSEO storage (in case the original source is not available) |
| **`product_ids`** | array | *Google Shopping product identifiers* array of Google Shopping product IDs associated with the product |
| `type` | string | *type of element = '**chat\_gpt\_google\_shopping\_product**'* |
| `ei` | string | *event identifier* internal event identifier used by Google |
| `product_id` | string | *product identifier* can be used as a `data_docid` in [Google Shopping API endpoints](https://docs.dataforseo.com/v3/merchant/google/overview.md) |
| `catalog_id` | string | *Google Shopping catalog identifier of the product* can be used as a `product_id` in [Google Shopping API endpoints](https://docs.dataforseo.com/v3/merchant/google/overview.md) |
| `gpcid` | string | *Google product cluster identifier* can be used as a `gid` in [Google Shopping API endpoints](https://docs.dataforseo.com/v3/merchant/google/overview.md) |
| `headline_offer_docid` | string | *document identifier of the main offer in the headline* can be used as a `data_docid` in [Google Shopping API endpoints](https://docs.dataforseo.com/v3/merchant/google/overview.md) |
| `image_docid` | string | *identifier for the displayed product’s image* |
| `rds` | string | *resource descriptor string* internal Google resource descriptor string that identifies the product within Google's Shopping index |
| `query` | string | *search query* search query used by ChatGPT to retrieve the product from Google Shopping |
| `mid` | string | *merchant identifier* identifier of the seller or merchant account in Google Shopping |
| `pvt` | string | *product view type* internal Google parameter that specifies the product view type used when rendering the product item |
| `uule` | string | *encoded location parameter* indicates the location for a search |
| `gl` | string | *country code* indicates the location for which search results are displayed |
| `hl` | string | *host language code* indicates the language in which search results are displayed |
| **`chat_gpt_ad`** | object | *element in the response* |
| `type` | string | *type of element*=***'chat\_gpt\_ad'*** |
| `rank_group` | integer | *group rank in SERP* position within a group of elements with identical `type` values positions of elements with different `type` values are omitted from `rank_group` |
| `rank_absolute` | integer | *absolute rank in SERP* absolute position among all the elements in SERP |
| `title` | string | *title of the ad* |
| `snippet` | string | *description text of the ad* |
| `url` | string | *URL of the ad landing page* |
| `domain` | string | *domain of the ad landing page* |
| `image_url` | string | *URL of the image displayed in the ad* |
| **`advertiser`** | object | *information about the advertiser associated with the ad* |
| `name` | string | *name of the advertiser* |
| `url` | string | *URL of the advertiser's website* |
| `favicon_url` | string | *URL of the advertiser's favicon image* |
> Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-access
```
# Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
login="login"
password="password"
cred="$(printf ${login}:${password} | base64)"
curl --location --request POST "https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/live/advanced"
--header "Authorization: Basic ${cred}"
--header "Content-Type: application/json"
--data-raw '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein"
}
]'
```
```php
getHttpCode()}n";
print "Error code: {$e->getCode()}n";
print "Message: {$e->getMessage()}n";
print $e->getTraceAsString();
echo "n";
exit();
}
$post_array = array();
// You can set only one task at a time
$post_array[] = array(
"language_code" => "en",
"location_code" => 2840,
"keyword" => mb_convert_encoding("albert einstein", "UTF-8")
);
if (count($post_array) > 0) {
try {
// POST /v3/ai_optimization/chat_gpt/llm_scraper/live/advanced
// in addition to 'chat_gpt' and 'llm_scraper' you can also set other search engine and type parameters
// the full list of possible parameters is available in documentation
$result = $client->post('/v3/ai_optimization/chat_gpt/llm_scraper/live/advanced', $post_array);
print_r($result);
// do something with post result
} catch (RestClientException $e) {
echo "n";
print "HTTP code: {$e->getHttpCode()}n";
print "Error code: {$e->getCode()}n";
print "Message: {$e->getMessage()}n";
print $e->getTraceAsString();
echo "n";
}
$client = null;
?>
```
```js
const axios = require('axios');
axios({
method: 'post',
url: 'https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/live/advanced',
auth: {
username: 'login',
password: 'password'
},
data: [{
"language_code": "en",
"location_code": 2840,
"keyword": encodeURI("albert einstein")
}],
headers: {
'content-type': 'application/json'
}
}).then(function (response) {
var result = response['data']['tasks'];
// Result data
console.log(result);
}).catch(function (error) {
console.log(error);
});
```
```
"""
Method: POST
Endpoint: https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/live/advanced
@see https://docs.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/live/advanced
"""
import sys
import os
sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), '../../../../../')))
from lib.client import RestClient
from lib.config import username, password
client = RestClient(username, password)
post_data = []
post_data.append({
language_code="en",
location_code=2840,
keyword="albert einstein"
})
try:
response = client.post('/v3/ai_optimization/chat_gpt/llm_scraper/live/advanced', post_data)
print(response)
# do something with post result
except Exception as e:
print(f'An error occurred: {e}')
```
```csharp
using System;
using System.Linq;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Collections.Generic;
using System.Threading.Tasks;
using Newtonsoft.Json;
namespace DataForSeoSdk;
public class AiOptimization
{
private static readonly HttpClient _httpClient;
static AiOptimization()
{
_httpClient = new HttpClient
{
BaseAddress = new Uri("https://api.dataforseo.com/")
};
_httpClient.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Basic", ApiConfig.Base64Auth);
}
///
/// Method: POST
/// Endpoint: https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/live/advanced
///
///
public static async Task ChatGptLlmResponsesLive()
{
var postData = new List