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. |
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, e.g. last_response_at GREATER_THAN 2026-06-01. |
top_n | integer | No | 5 | How many entries to keep in each breakdown list (top source domains, brands, locations…), 1 to 10. Defaults to 5. |
fields | string or array of string | No | - | Result columns to keep: target, 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. |