Get Top Mentioned

Rank the domains and pages that AI answers cite, or the brands and categories they name, alongside a brand, keyword or domain: finds AI visibility, AEO and GEO citation and PR targets and the competitors AI assistants recommend. Needs the DataForSEO LLM Mentions subscription.


App	DataForSEO
Operation ID	`dataforseo_get_top_mentioned`
Type	Action
Connection	`dataforseo` (required)
Credits per run	Free
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
`domains`	string or array of string	No	-	Domains that must appear in the AI answer, as a list or newline/comma-separated text (bare domains such as ahrefs.com). Use this to track a brand’s website being cited or linked. At least one domain or keyword is required; up to 10 targets in total.
`keywords`	string or array of string	No	-	Words or phrases that must appear in the AI answer, question or named brands, e.g. a brand name or a product category. List or newline/comma-separated text. All included domains and keywords must match together (AND).
`excluded_domains`	string or array of string	No	-	Domains that must NOT appear in the matched answers, e.g. wikipedia.org.
`excluded_keywords`	string or array of string	No	-	Words or phrases that must NOT appear in the matched answers.
`domain_scope`	string or SelectableOption	No	`any`	Where a domain has to appear: ‘any’ (default), ‘sources’ (cited in the answer) or ‘search_results’ (retrieved by the web search behind the answer; ChatGPT only).
`keyword_scope`	string or SelectableOption	No	`any`	Where a keyword has to appear: ‘any’ (default), ‘question’ (the user prompt), ‘answer’ (the AI answer text), ‘brand_entities’ (brands named in the answer) or ‘fan_out_queries’ (the follow-up searches the model ran).
`keyword_match_type`	string or SelectableOption	No	`word_match`	’word_match’ (default) matches whole words, so ‘light’ also matches ‘light bulb’; ‘partial_match’ matches substrings, so ‘light’ also matches ‘lighting’.
`include_subdomains`	boolean	No	`True`	Also match subdomains of the target domains, which includes the www. host most sites are cited under. Defaults to true; turn it off to count only the bare domain.
`platform`	string or SelectableOption	No	`all`	AI platform: ‘all’ (default), ‘google’ (Google AI Overviews and AI Mode) or ‘chat_gpt’. ChatGPT data exists for the United States in English only; every other location and language is Google only.
`location`	string or SelectableOption	No	`2840`	Country or location: a two-letter country code (us, gb, de…), a DataForSEO location code (2840 = United States) or a full location name. Defaults to the United States. Only locations listed by DataForSEO for LLM Mentions have data.
`language`	string or SelectableOption	No	`en`	Language code of the AI answers, e.g. en, de, es, fr, nl. Defaults to en.
`report`	string or SelectableOption	No	`domains`	What to rank: ‘domains’ (default) or ‘pages’ cited in the AI answers that mention the targets, or ‘brands’ or ‘brand_categories’ named in those answers. Brand data comes from ChatGPT answers only.
`links_scope`	string or SelectableOption	No	`sources`	domains and pages reports: count links from the cited ‘sources’ (default) or from the ‘search_results’ the model retrieved (ChatGPT only).
`dataset_filters`	array of FilterItem	No	-	Up to 8 filters applied to the AI answers before they are counted, on ai_search_volume, model_name, platform, location_code, language_code, is_web_search_based, first_response_at or last_response_at.
`filters`	array of FilterItem	No	-	Up to 8 filters on the ranked entries: domain, page, brand or brand_category, total.mentions and total.ai_search_volume, e.g. total.mentions GREATER_THAN 5.
`orders`	array of OrderItem	No	-	Sort by up to 3 of total.mentions, total.ai_search_volume or the entity name. Defaults to mentions descending.
`include_only`	string or array of string	No	-	Only return these domains, pages, brands or categories (list or comma-separated).
`exclude_results`	string or array of string	No	-	Leave these domains, pages, brands or categories out of the ranking.
`limit`	integer	No	`20`	Maximum number of ranked entries to return (1 to 1000). Defaults to 20. DataForSEO bills per row on top of the request fee.
`offset`	integer	No	-	Number of entries to skip, for paging.
`top_n`	integer	No	`5`	How many entries to keep in each breakdown list per row (locations, languages, source domains, brands…), 1 to 10. Defaults to 5.
`fields`	string or array of string	No	-	Result columns to keep: the entity column (domain, page, brand or brand_category), total.mentions, total.ai_search_volume, platform.chat_gpt.mentions, platform.chat_gpt.ai_search_volume, platform.google.mentions, platform.google.ai_search_volume, location, language, sources_domain, search_results_domain, brand_entities_title, brand_entities_category. Leave empty for all of them.

Field	Type	Required	Default	Description
`field`	string or SelectableOption	Yes	-	The field to filter on, must be one of the current selected metrics or dimensions.
`operator`	string	Yes	-	The operator to use for filtering. Must be one of the supported values. Use REGEXP_MATCH to search/filter by multiple OR values like ’.(summer\|holiday).’
`value`	string	Yes	-	The value to filter by, always as a string: text, a number, or a regex. For IN_LIST and NOT_IN_LIST, pass the values as one comma-separated string such as ‘a,b,c’, not as an array. For regex values, escape backslashes once in the JSON string: write \b for a word boundary, not \b.

OrderItem

Field	Type	Required	Default	Description
`field`	string or SelectableOption	Yes	-	The field to sort by. must be one of the current selected metrics or dimensions.
`direction`	string	Yes	-	The order to sort by, must be one of ‘ASC’, ‘DESC’

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Output

Type: List[Dict] Returns one row per ranked entry: domain, page, brand or brand_category depending on the report, total.mentions, total.ai_search_volume, platform.chat_gpt.mentions, platform.chat_gpt.ai_search_volume, platform.google.mentions, platform.google.ai_search_volume, and the breakdown lists location, language, sources_domain, search_results_domain, brand_entities_title, brand_entities_category (each a list of key, mentions, ai_search_volume limited to top_n entries). Fields: domain, total.mentions, total.ai_search_volume, platform.chat_gpt.mentions, platform.google.mentions, sources_domain, brand_entities_title Example:

[
  {
    "domain": "semrush.com",
    "total.mentions": 2310,
    "total.ai_search_volume": 540000
  }
]

Get Started

Guides

Operations

Inputs

FilterItem

OrderItem

SelectableOption

Output

​Inputs

​FilterItem

​OrderItem

​SelectableOption

​Output

Inputs

FilterItem

OrderItem

SelectableOption

Output