> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 compe...

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](http://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. |

### FilterItem

| 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**:

```json theme={"dark"}
[
  {
    "domain": "semrush.com",
    "total.mentions": 2310,
    "total.ai_search_volume": 540000
  }
]
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.