DataForSEOAI Search VisibilitySEO/AEO

Top domains in LLM mentions of a keyword or domain, lite

dataforseo.x.ai-optimization-llm-mentions-top-mentioned-domains-lite-live

Live LLM Mentions Top Mentioned Domains Lite endpoint is the simplified version of the Top Mentioned Domains endpoint and provides a simplified view of aggregated LLM mentions metrics grouped by the most frequently mentioned domains for the specified target.

Price: $0.103/callAt list price
Success rate: 100%Last 30 days · 15 calls
Latency p50: 1.4 sp95 9.6 s
Last verified: Jul 28, 2026Verified working

POSThttps://toolswitch.dev/v1/tools/dataforseo.x.ai-optimization-llm-mentions-top-mentioned-domains-lite-liveBeta

Try onlineProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Parameters

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"

Parameter	Type	Required	Description	Example
Request body (JSON)
`tag`	string	Optional	<em>user-defined task identifier</em><br>optional field<br><em>the character limit is 255</em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag</code> value in the <code>data</code> object of the response
`limit`	integer	Optional	<em>maximum number of results in the items array</em><br>optional field<br>you can use this parameter to limit the number of data objects you receive in the <code>items</code> array<br>minimum value: <code>1</code><br>maximum value: <code>1000</code><br>default value: <code>100</code>	`3`
`offset`	integer	Optional	<em>offset in the results array of the returned mentions data</em><br>optional field<p>default value: <code>0</code><br>example: if you specify the <code>10</code> value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;<br>
`target`	array	Optional	array of objects containing target entities. Required field. You can specify up to 10 entities (objects) in the target field. One target entity can contain either one domain or one keyword and related parameters. All target entities are AND-combined into one filter / one metrics series (not one series per brand). To compare brands: use dataforseo.x.ai-optimization-llm-mentions-multi-target-metrics-live, or one call per brand.	`[{"keyword":"bmw","search_scope":["answer"]},{"keyword":"auto","match_type":"partial_match","search_scope":["question"]}`
`filters`	array	Optional	<em>array of results filtering parameters</em><br>optional field<br><strong>you can add several filters at once (8 filters maximum)</strong><br>you should set a logical operator <code>and</code>, <code>or</code> between the conditions<br>the following operators are supported:<br><code>=</code>, <cod
`order_by`	array	Optional	<em>results sorting rules</em><br>optional field<br>you can use the same values as in the <code>filters</code> array to sort the results<br>possible sorting types:<br><code>asc</code> - results will be sorted in the ascending order<br><code>desc</code> - results will be sorted in the descending orde
`platform`	string	Optional	target platform. Optional field. Possible values: chat_gpt, google. When omitted, DataForSEO defaults to google only (not both platforms). chat_gpt data is available for the United States and English only (location 2840 / US + language en; else task status 40501).	`chat_gpt`
`links_scope`	string	Optional	<em>links source scope</em><br>optional field<br>this parameter specifies which links will be used to extract domains and aggregation data<br>possible values: <code>sources</code>, <code>search_results</code><br>default value: <code>sources</code>	`sources`
`language_code`	string	Optional	<em>search language code</em><br>optional field<br>if you use this field, you don't need to specify <code>language_name</code>;<br>you can receive the list of available languages of the search engine with their <code>language_code</code>_by making a separate request to the <code>https://api.datafors	`en`
`language_name`	string	Optional	<em>full name of search language</em><br>optional field<br>if you use this field, you don't need to specify <code>language_code</code>;<br>if you don't specify this field, the <code>language_code</code> with <code class="long-string">en</code> value will be used by default;<br>you can receive the li
`location_code`	integer	Optional	search location code. Optional field. If you use this field, you don't need to specify location_name. Default is 2840 (United States). With platform=chat_gpt, only 2840 is valid; any other code (e.g. 2036) returns task status 40501 Invalid Field: 'location_code'. The HTTP envelope may still be 200 / top-level status_code 20000 Ok with items_count=0 — always check tasks[].status_code / status_message.	`2840`
`location_name`	string	Optional	full name of search location. Optional field. If you use this field, you don't need to specify location_code. Default is United States (location_code 2840). With platform=chat_gpt, only United States is valid; other names return the same task status 40501 Invalid Field on location. The HTTP envelope may still be 200 / top-level status_code 20000 Ok with items_count=0 — always check tasks[].status_code / status_message.
`exclude_domains`	array	Optional	<em>array of domains to exclude from the response</em><br>optional field<br>if specified, the listed domains will be omitted from the <code>items</code> array<br>example:<br><code>["google.com","bing.com"]</code>
`include_domains`	array	Optional	<em>array of domains to include in the response</em><br>optional field<br>if specified, only the listed domains will be returned in the <code>items</code> array<br>example:<br><code>["dataforseo.com","seoinsider.com"]</code>
`internal_list_limit`	integer	Optional	<em>maximum number of elements within internal arrays</em><br>optional field<br>you can use this field to limit the number of elements within the following arrays:<br><code>sources_domain</code>, <code>search_results_domain</code>, <code>brand_entities_title</code>, <code>brand_entities_category</co	`2`
`initial_dataset_filters`	array	Optional	<em>array of filter expressions applied before aggregation</em><br>optional field<br>you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;<p><strong>you can add several filters at once (8 filters maximum)</s	`[["ai_search_volume",">",10]]`

Request body (JSON)
tagstringOptional
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 <code>tag</code> value in the <code>data</code> object of the response
limitintegerOptional
maximum number of results in the items array optional field you can use this parameter to limit the number of data objects you receive in the <code>items</code> array minimum value: <code>1</code> maximum value: <code>1000</code> default value: <code>100</code>
Example: 3
offsetintegerOptional
offset in the results array of the returned mentions data optional fielddefault value: <code>0</code> example: if you specify the <code>10</code> value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
targetarrayOptional
array of objects containing target entities. Required field. You can specify up to 10 entities (objects) in the target field. One target entity can contain either one domain or one keyword and related parameters. All target entities are AND-combined into one filter / one metrics series (not one series per brand). To compare brands: use dataforseo.x.ai-optimization-llm-mentions-multi-target-metrics-live, or one call per brand.
Example: [{"keyword":"bmw","search_scope":["answer"]},{"keyword":"auto","match_type":"partial_match","search_scope":["question"]}
filtersarrayOptional
array of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator <code>and</code>, <code>or</code> between the conditions the following operators are supported: <code>=</code>, <cod
order_byarrayOptional
results sorting rules optional field you can use the same values as in the <code>filters</code> array to sort the results possible sorting types: <code>asc</code> - results will be sorted in the ascending order <code>desc</code> - results will be sorted in the descending orde
platformstringOptional
target platform. Optional field. Possible values: chat_gpt, google. When omitted, DataForSEO defaults to google only (not both platforms). chat_gpt data is available for the United States and English only (location 2840 / US + language en; else task status 40501).
Example: chat_gpt
links_scopestringOptional
links source scope optional field this parameter specifies which links will be used to extract domains and aggregation data possible values: <code>sources</code>, <code>search_results</code> default value: <code>sources</code>
Example: sources
language_codestringOptional
search language code optional field if you use this field, you don't need to specify <code>language_name</code>; you can receive the list of available languages of the search engine with their <code>language_code</code>_by making a separate request to the <code>https://api.datafors
Example: en
language_namestringOptional
full name of search language optional field if you use this field, you don't need to specify <code>language_code</code>; if you don't specify this field, the <code>language_code</code> with <code class="long-string">en</code> value will be used by default; you can receive the li
location_codeintegerOptional
search location code. Optional field. If you use this field, you don't need to specify location_name. Default is 2840 (United States). With platform=chat_gpt, only 2840 is valid; any other code (e.g. 2036) returns task status 40501 Invalid Field: 'location_code'. The HTTP envelope may still be 200 / top-level status_code 20000 Ok with items_count=0 — always check tasks[].status_code / status_message.
Example: 2840
location_namestringOptional
full name of search location. Optional field. If you use this field, you don't need to specify location_code. Default is United States (location_code 2840). With platform=chat_gpt, only United States is valid; other names return the same task status 40501 Invalid Field on location. The HTTP envelope may still be 200 / top-level status_code 20000 Ok with items_count=0 — always check tasks[].status_code / status_message.
exclude_domainsarrayOptional
array of domains to exclude from the response optional field if specified, the listed domains will be omitted from the <code>items</code> array example: <code>["google.com","bing.com"]</code>
include_domainsarrayOptional
array of domains to include in the response optional field if specified, only the listed domains will be returned in the <code>items</code> array example: <code>["dataforseo.com","seoinsider.com"]</code>
internal_list_limitintegerOptional
maximum number of elements within internal arrays optional field you can use this field to limit the number of elements within the following arrays: <code>sources_domain</code>, <code>search_results_domain</code>, <code>brand_entities_title</code>, <code>brand_entities_category</co
Example: 2
initial_dataset_filtersarrayOptional
array of filter expressions applied before aggregation optional field you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;you can add several filters at once (8 filters maximum)</s
Example: [["ai_search_volume",">",10]]

Code samples

Replace $TOOLSWITCH_KEY with the key you created in the console.

Beta

curl -X POST 'https://toolswitch.dev/v1/tools/dataforseo.x.ai-optimization-llm-mentions-top-mentioned-domains-lite-live' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '[{"limit":3,"target":[{"keyword":"bmw","search_scope":["answer"]},{"keyword":"auto","match_type":"partial_match","search_scope":["question"]}],"platform":"chat_gpt","links_scope":"sources","language_code":"en","location_code":2840,"internal_list_limit":2,"initial_dataset_filters":[["ai_search_volume",">",10]]}]'

import os
import json
import requests

response = requests.request(
    "POST",
    "https://toolswitch.dev/v1/tools/dataforseo.x.ai-optimization-llm-mentions-top-mentioned-domains-lite-live",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
    json=json.loads("[{\"limit\":3,\"target\":[{\"keyword\":\"bmw\",\"search_scope\":[\"answer\"]},{\"keyword\":\"auto\",\"match_type\":\"partial_match\",\"search_scope\":[\"question\"]}],\"platform\":\"chat_gpt\",\"links_scope\":\"sources\",\"language_code\":\"en\",\"location_code\":2840,\"internal_list_limit\":2,\"initial_dataset_filters\":[[\"ai_search_volume\",\">\",10]]}]"),
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/dataforseo.x.ai-optimization-llm-mentions-top-mentioned-domains-lite-live", {
  method: "POST",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
    "Content-Type": "application/json",
  },
  body: JSON.stringify(JSON.parse("[{\"limit\":3,\"target\":[{\"keyword\":\"bmw\",\"search_scope\":[\"answer\"]},{\"keyword\":\"auto\",\"match_type\":\"partial_match\",\"search_scope\":[\"question\"]}],\"platform\":\"chat_gpt\",\"links_scope\":\"sources\",\"language_code\":\"en\",\"location_code\":2840,\"internal_list_limit\":2,\"initial_dataset_filters\":[[\"ai_search_volume\",\">\",10]]}]")),
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

This gateway API is in beta; its URL and authentication may change. The example parameters are sample data. Calls are billed at $0.103/call, including the service fee.