DataForSEO — Ai Optimization / Llm Mentions / Top Mentioned Brand Categories / Live
Retrieve ai Optimization Llm Mentions Top Mentioned Brand Categories Live with the DataForSEO API. The results are specific to the selected platform, location and language parameters (. Use it for search visibility research or technical SEO.
- Selected price
- $0.1 base + $0.001 / result Published pricing
- Sellers / implementations
- 1 / 1
- Requests · 30d
- —Loading...
- Success rate · 30d
- —Loading...
| Seller | Pricing | Requests · 30d | Performance | Access |
|---|---|---|---|---|
DataForSEOCurrent DataForSEO — Ai Optimization / Llm Mentions / Top Mentioned Brand Categories / Live · POST | $0.1 base + $0.001 / result | — | —successP50— |
Run sends a real API request. Charges follow the published API contract.
Response structure
costnumberstatus_codeintegerstatus_messagestringtasksobject[]costnumberdataobjectapistringexclude_brand_categoriesstring[]filtersstring[][]functionstringinclude_brand_categoriesstring[]initial_dataset_filters((string | boolean)[])[]internal_list_limitintegerlanguage_codestringlimitintegerlocation_codeintegeroffsetintegerorder_bystring[]platformstringtargetobject[]keywordstringsearch_filterstringsearch_scopestring[]
idstringpathstring[]resultobject[]aggregated_metricsobjectbrand_entities_categoryobject[]ai_search_volumeintegerkeystringmentionsinteger
brand_entities_titleobject[]ai_search_volumeintegerkeystringmentionsinteger
languageobject[]ai_search_volumeintegerkeystringmentionsinteger
locationobject[]ai_search_volumeintegerkeyintegermentionsinteger
platformobject[]ai_search_volumeintegerkeystringmentionsinteger
search_results_domainobject[]ai_search_volumeintegerkeystringmentionsinteger
sources_domainobject[]ai_search_volumeintegerkeystringmentionsinteger
totalobjectai_search_volumeintegermentionsinteger
itemsobject[]brand_categorystringbrand_entities_categoryobject[]ai_search_volumeintegerkeystringmentionsinteger
brand_entities_titleobject[]ai_search_volumeintegerkeystringmentionsinteger
languageobject[]ai_search_volumeintegerkeystringmentionsinteger
locationobject[]ai_search_volumeintegerkeyintegermentionsinteger
platformobject[]ai_search_volumeintegerkeystringmentionsinteger
search_results_domainobject[]ai_search_volumeintegerkeystringmentionsinteger
sources_domainobject[]ai_search_volumeintegerkeystringmentionsinteger
totalobjectai_search_volumeintegermentionsinteger
items_countintegeroffsetintegertotal_countinteger
result_countintegerstatus_codeintegerstatus_messagestringtimestring
tasks_countintegertasks_errorintegertimestringversionstring
// Inferred from response examples. Fields are optional and other fields may be returned.
export type ApiResponse = {
cost?: number;
status_code?: number;
status_message?: string;
tasks?: Array<{
cost?: number;
data?: {
api?: string;
exclude_brand_categories?: Array<string>;
filters?: Array<Array<string>>;
function?: string;
include_brand_categories?: Array<string>;
initial_dataset_filters?: Array<Array<string | boolean>>;
internal_list_limit?: number;
language_code?: string;
limit?: number;
location_code?: number;
offset?: number;
order_by?: Array<string>;
platform?: string;
target?: Array<{
keyword?: string;
search_filter?: string;
search_scope?: Array<string>;
}>;
};
id?: string;
path?: Array<string>;
result?: Array<{
aggregated_metrics?: {
brand_entities_category?: Array<{
ai_search_volume?: number;
key?: string;
mentions?: number;
}>;
brand_entities_title?: Array<{
ai_search_volume?: number;
key?: string;
mentions?: number;
}>;
language?: Array<{
ai_search_volume?: number;
key?: string;
mentions?: number;
}>;
location?: Array<{
ai_search_volume?: number;
key?: number;
mentions?: number;
}>;
platform?: Array<{
ai_search_volume?: number;
key?: string;
mentions?: number;
}>;
search_results_domain?: Array<{
ai_search_volume?: number;
key?: string;
mentions?: number;
}>;
sources_domain?: Array<{
ai_search_volume?: number;
key?: string;
mentions?: number;
}>;
total?: {
ai_search_volume?: number;
mentions?: number;
};
};
items?: Array<{
brand_category?: string;
brand_entities_category?: Array<{
ai_search_volume?: number;
key?: string;
mentions?: number;
}>;
brand_entities_title?: Array<{
ai_search_volume?: number;
key?: string;
mentions?: number;
}>;
language?: Array<{
ai_search_volume?: number;
key?: string;
mentions?: number;
}>;
location?: Array<{
ai_search_volume?: number;
key?: number;
mentions?: number;
}>;
platform?: Array<{
ai_search_volume?: number;
key?: string;
mentions?: number;
}>;
search_results_domain?: Array<{
ai_search_volume?: number;
key?: string;
mentions?: number;
}>;
sources_domain?: Array<{
ai_search_volume?: number;
key?: string;
mentions?: number;
}>;
total?: {
ai_search_volume?: number;
mentions?: number;
};
}>;
items_count?: number;
offset?: number;
total_count?: number;
}>;
result_count?: number;
status_code?: number;
status_message?: string;
time?: string;
}>;
tasks_count?: number;
tasks_error?: number;
time?: string;
version?: string;
};- Method
- POST
- Endpoint
https://api.openany.si/v1/agent-apis/dataforseo/v3/ai_optimization/llm_mentions/top_mentioned_brand_categories/live- Content type
- application/json
- Authentication
Authorization: Bearer $OPENANY_API_KEY
curl \
'https://api.openany.si/v1/agent-apis/dataforseo/v3/ai_optimization/llm_mentions/top_mentioned_brand_categories/live' \
-X POST \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '[
{
"exclude_brand_categories": [
"insurance"
],
"filters": [
[
"brand_category",
"like",
"%comp%"
]
],
"include_brand_categories": [
"company"
],
"initial_dataset_filters": [
[
"is_web_search_based",
"=",
true
]
],
"internal_list_limit": 5,
"language_code": "en",
"limit": 5,
"location_code": 2840,
"offset": 0,
"order_by": [
"total.mentions,desc"
],
"platform": "chat_gpt",
"target": [
{
"keyword": "bmw",
"search_filter": "include",
"search_scope": [
"answer"
]
}
]
}
]'Input parameters
Fields in this listing; additional options and input encoding can vary by provider.
| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
body | JSON request bodybody | array | Yes | Live LLM Mentions Top Mentioned Brand Categories endpoint provides aggregated LLM mentions metrics grouped by the most frequently mentioned brand categories for the specified target. The results are specific to the selected platform, location and language parameters (see the List of Locations & Languages). minItems: 1 · maxItems: 1 Nested fields and variants
Nested fields and variants
|
Required markers inside a nested object or variant apply when that object or variant is used.
Sample response
Sample response · Documented HTTP 200 Example from the provider's documentation. Field values in your results will differ.
{
"cost": 0.101,
"status_code": 20000,
"status_message": "Ok.",
"tasks": [
{
"cost": 0.101,
"data": {
"api": "ai_optimization",
"exclude_brand_categories": [
"insurance"
],
"filters": [
[
"brand_category",
"like",
"%comp%"
]
],
"function": "top_mentioned_brand_categories",
"include_brand_categories": [
"company"
],
"initial_dataset_filters": [
[
"is_web_search_based",
"=",
true
]
],
"internal_list_limit": 5,
"language_code": "en",
"limit": 5,
"location_code": 2840,
"offset": 0,
"order_by": [
"total.mentions,desc"
],
"platform": "chat_gpt",
"target": [
{
"keyword": "bmw",
"search_filter": "include",
"search_scope": [
"answer"
]
}
]
},
"id": "06241340-1444-0656-0000-241dab846eef",
"path": [
"v3",
"ai_optimization",
"llm_mentions",
"top_mentioned_brand_categories",
"live"
],
"result": [
{
"aggregated_metrics": {
"brand_entities_category": [
{
"ai_search_volume": 157351,
"key": "company",
"mentions": 3253
},
{
"ai_search_volume": 52846,
"key": "vehicle",
"mentions": 720
},
{
"ai_search_volume": 13388,
"key": "brand",
"mentions": 254
},
{
"ai_search_volume": 9864,
"key": "people",
"mentions": 187
},
{
"ai_search_volume": 3758,
"key": "organization",
"mentions": 102
}
],
"brand_entities_title": [
{
"ai_search_volume": 12274,
"key": "BMW",
"mentions": 412
},
{
"ai_search_volume": 21354,
"key": "German automaker",
"mentions": 397
},
{
"ai_search_volume": 5057,
"key": "Mercedes-Benz",
"mentions": 209
},
{
"ai_search_volume": 16851,
"key": "German luxury automaker",
"mentions": 195
},
{
"ai_search_volume": 24707,
"key": "Japanese automaker",
"mentions": 185
}
],
"language": [
{
"ai_search_volume": 157351,
"key": "en",
"mentions": 3253
}
],
"location": [
{
"ai_search_volume": 157351,
"key": 2840,
"mentions": 3253
}
],
"platform": [
{
"ai_search_volume": 157351,
"key": "chat_gpt",
"mentions": 3253
}
],
"search_results_domain": [
{
"ai_search_volume": 17016,
"key": "carinterior.alibaba.com",
"mentions": 372
},
{
"ai_search_volume": 12772,
"key": "www.motortrend.com",
"mentions": 341
},
{
"ai_search_volume": 14738,
"key": "www.alibaba.com",
"mentions": 340
},
{
"ai_search_volume": 25687,
"key": "www.slashgear.com",
"mentions": 279
},
{
"ai_search_volume": 7062,
"key": "www.motor1.com",
"mentions": 197
}
],
"sources_domain": [
{
"ai_search_volume": 29323,
"key": "en.wikipedia.org",
"mentions": 790
},
{
"ai_search_volume": 44264,
"key": "www.reddit.com",
"mentions": 434
},
{
"ai_search_volume": 12531,
"key": "www.reuters.com",
"mentions": 130
},
{
"ai_search_volume": 4986,
"key": "www.caranddriver.com",
"mentions": 126
},
{
"ai_search_volume": 4494,
"key": "www.consumerreports.org",
"mentions": 102
}
],
"total": {
"ai_search_volume": 157351,
"mentions": 3253
}
},
"items": [
{
"brand_category": "company",
"brand_entities_category": [
{
"ai_search_volume": 157351,
"key": "company",
"mentions": 3253
},
{
"ai_search_volume": 52846,
"key": "vehicle",
"mentions": 720
},
{
"ai_search_volume": 13388,
"key": "brand",
"mentions": 254
},
{
"ai_search_volume": 9864,
"key": "people",
"mentions": 187
},
{
"ai_search_volume": 3758,
"key": "organization",
"mentions": 102
}
],
"brand_entities_title": [
{
"ai_search_volume": 12274,
"key": "BMW",
"mentions": 412
},
{
"ai_search_volume": 21354,
"key": "German automaker",
"mentions": 397
},
{
"ai_search_volume": 5057,
"key": "Mercedes-Benz",
"mentions": 209
},
{
"ai_search_volume": 16851,
"key": "German luxury automaker",
"mentions": 195
},
{
"ai_search_volume": 24707,
"key": "Japanese automaker",
"mentions": 185
}
],
"language": [
{
"ai_search_volume": 157351,
"key": "en",
"mentions": 3253
}
],
"location": [
{
"ai_search_volume": 157351,
"key": 2840,
"mentions": 3253
}
],
"platform": [
{
"ai_search_volume": 157351,
"key": "chat_gpt",
"mentions": 3253
}
],
"search_results_domain": [
{
"ai_search_volume": 17016,
"key": "carinterior.alibaba.com",
"mentions": 372
},
{
"ai_search_volume": 12772,
"key": "www.motortrend.com",
"mentions": 341
},
{
"ai_search_volume": 14738,
"key": "www.alibaba.com",
"mentions": 340
},
{
"ai_search_volume": 25687,
"key": "www.slashgear.com",
"mentions": 279
},
{
"ai_search_volume": 7062,
"key": "www.motor1.com",
"mentions": 197
}
],
"sources_domain": [
{
"ai_search_volume": 29323,
"key": "en.wikipedia.org",
"mentions": 790
},
{
"ai_search_volume": 44264,
"key": "www.reddit.com",
"mentions": 434
},
{
"ai_search_volume": 12531,
"key": "www.reuters.com",
"mentions": 130
},
{
"ai_search_volume": 4986,
"key": "www.caranddriver.com",
"mentions": 126
},
{
"ai_search_volume": 4494,
"key": "www.consumerreports.org",
"mentions": 102
}
],
"total": {
"ai_search_volume": 157351,
"mentions": 3253
}
}
],
"items_count": 1,
"offset": 0,
"total_count": 1
}
],
"result_count": 1,
"status_code": 20000,
"status_message": "Ok.",
"time": "1.5921 sec."
}
],
"tasks_count": 1,
"tasks_error": 0,
"time": "1.6363 sec.",
"version": "0.1.20260610"
}Composite rule pricing
Calculated from input parameters and actual returned quantities. Estimate the maximum cost before calling.
Base fee: $0.100000. One matching variant replaces the base fee. Matching add-ons and quantity charges are added.
| Fee item | Price | Metering source | When | Quantity limit |
|---|---|---|---|---|
| 任务错误数必须为零 | $0.000000 / billing unit | Response · /tasks_error · Numeric value | Always | 0 billing unit · Decimal places: 0 |
| 本次返回结果 | $0.001000 / result | Response · /tasks/0/result/0/items_count · Numeric value | Always | 1000 result · Decimal places: 0 |
Each quantity charge is rounded before summing: ceil. Requests exceeding this cost limit are rejected; it is not a price cap: $1.100000.
Response quantities settle after the response. Before execution, the maximum quantity determines the reservation; unused reservation is released. Missing or invalid quantities are not treated as zero.
Pricing parameters and defaults
[]
Agent integration
Copy the resource contract without sharing an API key.
View API Markdown
# DataForSEO — Ai Optimization / Llm Mentions / Top Mentioned Brand Categories / Live
Retrieve ai Optimization Llm Mentions Top Mentioned Brand Categories Live with the DataForSEO API. The results are specific to the selected platform, location and language parameters (. Use it for search visibility research or technical SEO.
## Available implementations
DataForSEO · DataForSEO — Ai Optimization / Llm Mentions / Top Mentioned Brand Categories / Live: https://openany.si/markets/apis/capabilities/dataforseo-ai-optimization-llm-mentions-top-mentioned-brand-categories-live?offering=de3d953d-a935-47cf-abe8-8670d0b645d1 · $0.1 base + $0.001 / result
## Selected API contract
Documentation: https://openany.si/markets/apis/capabilities/dataforseo-ai-optimization-llm-mentions-top-mentioned-brand-categories-live
Method: POST
Endpoint: https://api.openany.si/v1/agent-apis/dataforseo/v3/ai_optimization/llm_mentions/top_mentioned_brand_categories/live
Price: $0.1 base + $0.001 / result
Provider: DataForSEO
Contract revision: 3
Price source: OpenAny public API contract and documented provider unit rates. Price update time: not supplied.
Use OPENANY_API_KEY from the environment. API Key calls use your shared balance.
## Prepared request
```bash
curl \
'https://api.openany.si/v1/agent-apis/dataforseo/v3/ai_optimization/llm_mentions/top_mentioned_brand_categories/live' \
-X POST \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '[
{
"exclude_brand_categories": [
"insurance"
],
"filters": [
[
"brand_category",
"like",
"%comp%"
]
],
"include_brand_categories": [
"company"
],
"initial_dataset_filters": [
[
"is_web_search_based",
"=",
true
]
],
"internal_list_limit": 5,
"language_code": "en",
"limit": 5,
"location_code": 2840,
"offset": 0,
"order_by": [
"total.mentions,desc"
],
"platform": "chat_gpt",
"target": [
{
"keyword": "bmw",
"search_filter": "include",
"search_scope": [
"answer"
]
}
]
}
]'
```
## API contract
```json
{
"resource_type": "api",
"name": "DataForSEO — Ai Optimization / Llm Mentions / Top Mentioned Brand Categories / Live",
"endpoint": "https://api.openany.si/v1/agent-apis/dataforseo/v3/ai_optimization/llm_mentions/top_mentioned_brand_categories/live",
"method": "POST",
"content_type": "application/json",
"execution_mode": "sync",
"authentication": {
"type": "bearer",
"environment_variable": "OPENANY_API_KEY"
},
"inputs": [
{
"description": " Live LLM Mentions Top Mentioned Brand Categories endpoint provides aggregated LLM mentions metrics grouped by the most frequently mentioned brand categories for the specified target. The results are specific to the selected platform, location and language parameters (see the List of Locations & Languages).",
"json_schema": {
"example": [
{
"initial_dataset_filters": [
[
"ai_search_volume",
">",
10
]
],
"internal_list_limit": 2,
"language_code": "en",
"limit": 3,
"location_code": 2840,
"platform": "chat_gpt",
"target": [
{
"keyword": "bmw",
"search_scope": [
"answer"
]
},
{
"keyword": "auto",
"match_type": "partial_match",
"search_scope": [
"question"
]
}
]
}
],
"items": {
"example": [
{
"initial_dataset_filters": [
[
"ai_search_volume",
">",
10
]
],
"internal_list_limit": 2,
"language_code": "en",
"limit": 3,
"location_code": 2840,
"platform": "chat_gpt",
"target": [
{
"keyword": "bmw",
"search_scope": [
"answer"
]
},
{
"keyword": "auto",
"match_type": "partial_match",
"search_scope": [
"question"
]
}
]
}
],
"nullable": true,
"properties": {
"exclude_brand_categories": {
"description": "array of brand categories to exclude from the response optional field if specified, the listed brand categories will be omitted from the items array example: \"exclude_brand_categories\": [\"business\"]",
"items": {
"type": "string"
},
"nullable": true,
"type": "array",
"x-required-status": "optional"
},
"filters": {
"allOf": [
{
"anyOf": [
{
"anyOf": [
{
"items": false,
"maxItems": 3,
"minItems": 3,
"prefixItems": [
{
"type": "string"
},
{
"type": "string"
},
{}
],
"type": "array"
},
{
"items": {
"anyOf": [
{
"type": "array"
},
{
"enum": [
"and",
"or"
],
"type": "string"
}
]
},
"minItems": 1,
"type": "array"
}
],
"description": "官方过滤器文档中的条件三元组或由 and/or 连接的条件数组;仅检查外层结构,嵌套数组、操作符和值的完整语义仍以官方文档为准。",
"x-coverage": "outer_structure_only_nested_operator_semantics_not_exhaustively_validated",
"x-schema-origin": "derived_from_official_filter_prose_and_examples"
},
{
"type": "null"
}
]
}
],
"description": "array of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator and, or between the conditions the following operators are supported: =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match you can use the % operator with like and not_like to match any string of zero or more characters example: [\"ai_search_volume\",\">\",1000] The full list of possible filters is available here.",
"nullable": true,
"type": "array",
"x-original-openapi-description": "array of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator and , or between the conditions the following operators are supported: = , <> , in , not_in , like , not_like , ilike , not_ilike , match , not_match you can use the % operator with like and not_like to match any string of zero or more characters example: [\"ai_search_volume\",\">\",1000] The full list of possible filters is available here.",
"x-required-status": "optional",
"x-schema-origin": "official_filter_prose_normalized"
},
"include_brand_categories": {
"description": "array of brand_categories to include in the response optional field if specified, only the listed brand categories will be returned in the items array example: \"include_brand_categories\": [\"business\"]",
"items": {
"type": "string"
},
"nullable": true,
"type": "array",
"x-required-status": "optional"
},
"initial_dataset_filters": {
"allOf": [
{
"anyOf": [
{
"anyOf": [
{
"items": false,
"maxItems": 3,
"minItems": 3,
"prefixItems": [
{
"type": "string"
},
{
"type": "string"
},
{}
],
"type": "array"
},
{
"items": {
"anyOf": [
{
"type": "array"
},
{
"enum": [
"and",
"or"
],
"type": "string"
}
]
},
"minItems": 1,
"type": "array"
}
],
"description": "官方过滤器文档中的条件三元组或由 and/or 连接的条件数组;仅检查外层结构,嵌套数组、操作符和值的完整语义仍以官方文档为准。",
"x-coverage": "outer_structure_only_nested_operator_semantics_not_exhaustively_validated",
"x-schema-origin": "derived_from_official_filter_prose_and_examples"
},
{
"type": "null"
}
]
}
],
"description": "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) you should set a logical operator and, or between the conditions the following operators are supported: =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match you can use the % operator with like and not_like to match any string of zero or more characters example: [\"ai_search_volume\",\">\",1000] the full list of possible filters is available here. learn more about the initial dataset filters in this help center article.",
"nullable": true,
"type": "array",
"x-original-openapi-description": "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) you should set a logical operator and , or between the conditions the following operators are supported: = , <> , in , not_in , like , not_like , ilike , not_ilike , match , not_match you can use the % operator with like and not_like to match any string of zero or more characters example: [\"ai_search_volume\",\">\",1000] the full list of possible filters is available here. learn more about the initial dataset filters in this help center article.",
"x-required-status": "optional",
"x-schema-origin": "official_filter_prose_normalized"
},
"internal_list_limit": {
"default": 5,
"description": "maximum number of elements within internal arrays optional field you can use this field to limit the number of elements within the following arrays: sources_domain, search_results_domain, brand_entities_title, brand_entities_category minimum value: 1 maximum value: 10 default value: 5",
"maximum": 10,
"minimum": 1,
"nullable": true,
"type": "integer",
"x-constraints-from-official-description": [
"default",
"maximum",
"minimum"
],
"x-original-openapi-description": "maximum number of elements within internal arrays optional field you can use this field to limit the number of elements within the following arrays: sources_domain , search_results_domain , brand_entities_title , brand_entities_category minimum value: 1 maximum value: 10 default value: 5",
"x-required-status": "optional"
},
"language_code": {
"description": "search language code optional field 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/llm_mentions/locations_and_languages default value: en Note: chat_gpt data is available for en only",
"nullable": true,
"type": "string",
"x-original-openapi-description": "search language code optional field 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/llm_mentions/locations_and_languages default value: en Note: chat_gpt data is available for en only",
"x-required-status": "optional"
},
"language_name": {
"description": "full name of search language optional field if you use this field, you don't need to specify language_code; if you don't specify this field, the language_code with en value will be used by default; 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/llm_mentions/locations_and_languages Note: chat_gpt data is available for English only",
"nullable": true,
"type": "string",
"x-original-openapi-description": "full name of search language optional field if you use this field, you don't need to specify language_code ; if you don't specify this field, the language_code with en value will be used by default; 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/llm_mentions/locations_and_languages Note: chat_gpt data is available for English only",
"x-required-status": "optional"
},
"limit": {
"default": 100,
"description": "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 items array minimum value: 1 maximum value: 1000 default value: 100",
"maximum": 1000,
"minimum": 1,
"nullable": true,
"type": "integer",
"x-constraints-from-official-description": [
"default",
"maximum",
"minimum"
],
"x-required-status": "optional"
},
"location_code": {
"default": 2840,
"description": "search location code optional field if you use this field, you don't need to specify location_name you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages default value: 2840 Note: chat_gpt data is available for 2840 only",
"nullable": true,
"type": "integer",
"x-constraints-from-official-description": [
"default"
],
"x-required-status": "optional"
},
"location_name": {
"description": "full name of search location optional field if you use this field, you don't need to specify location_code if you don't specify this field, the location_code with 2840 value will be used by default; 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/llm_mentions/locations_and_languages Note: chat_gpt data is available for United States only",
"nullable": true,
"type": "string",
"x-required-status": "optional"
},
"offset": {
"default": 0,
"description": "offset in the results array of the returned mentions data optional field default value: 0 example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects; Note: the maximum value is 1000000",
"nullable": true,
"type": "integer",
"x-constraints-from-official-description": [
"default"
],
"x-required-status": "optional"
},
"order_by": {
"description": "results sorting rules optional field you can use the same values as in the filters array to sort the results possible sorting types: asc - results will be sorted in the ascending order desc - results will be sorted in the descending order you should use a comma to set up a sorting type example: [\"ai_search_volume,desc\"] Note: you can set no more than three sorting rules in a single request you should use a comma to separate several sorting rules",
"items": {
"type": "string"
},
"nullable": true,
"type": "array",
"x-required-status": "optional"
},
"platform": {
"description": "target platform optional field possible values: chat_gpt, google Note: data specific to brand entities is available for chat_gpt only; Note #2: chat_gpt data is available for the United States and English only",
"nullable": true,
"type": "string",
"x-original-openapi-description": "target platform optional field possible values: chat_gpt , google Note: data specific to brand entities is available for chat_gpt only; Note #2: chat_gpt data is available for the United States and English only",
"x-required-status": "optional"
},
"tag": {
"description": "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",
"nullable": true,
"type": "string",
"x-required-status": "optional"
},
"target": {
"description": "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 examples: target array with a domain entity [{\"domain\": \"en.wikipedia.org\", \"search_filter\": \"exclude\"}] target array with a keyword entity [{\"keyword\": \"bmw\", \"search_scope\": [\"question\"], \"match_type \": \"partial_match\"}] target array with multiple entities [{\"domain\": \"en.wikipedia.org\", \"search_filter\": \"exclude\"}, {\"keyword\": \"bmw\", \"match_type \": \"partial_match\", \"search_scope\": [\"answer\"]}] Note: requests must include at least one domain_entity or keyword_entity with \"search_filter\": \"include\".",
"items": {
"nullable": true,
"properties": {
"domain": {
"description": "target domain\nrequired field if you don’t specify keyword\na domain should be specified without https:// and www.",
"nullable": true,
"type": "string"
},
"include_subdomains": {
"description": "indicates if the subdomains of the target domain will be included in the search\noptional field\nif set to true, the subdomains will be included in the search\ndefault value: false",
"nullable": true,
"type": "boolean"
},
"keyword": {
"description": "target keyword\nrequired field if you don’t specify domain\nyou can specify up to 2000 characters in the keyword field\nall %## will be decoded (plus character ‘+’ will be decoded to a space character)\nif you need to use the “%” character for your keyword, please specify it as “%25”;\nif you need to use the “+” character for your keyword, please specify it as “%2B”\nlearn more about rules and limitations of keyword and keywords fields in",
"nullable": true,
"type": "string"
},
"match_type": {
"description": "target keyword match type\ndefines how the specified keyword is matched\noptional field\npossible values:\nword_match – full-text search for terms that match the specified seed keyword with additional words included before, after, or within the key phrase (e.g., search for “light” will return results with “light bulb”, “light switch”);\npartial_match – substring search that finds all instances containing the specified sequence of characters, even if it appears inside a longer word (e.g., search for “light” will return results with “lighting”, “highlight”);\ndefault value: word_match",
"nullable": true,
"type": "string"
},
"search_filter": {
"description": "target domain search filter\noptional field\npossible values:\ninclude, exclude\ndefault value: include",
"nullable": true,
"type": "string"
},
"search_scope": {
"description": "target domain search scope\noptional field\npossible values:\nany, sources, search_results\ndefault value: any",
"items": {
"nullable": true,
"type": "string"
},
"nullable": true,
"type": "array"
}
},
"type": "object",
"x-discriminator-expansion": {
"scope": "documented_subtype_properties_expanded_conditional_requirements_remain_in_prose",
"subtypes": [
"AiOptimizationLLmMentionsDomainElement",
"AiOptimizationLLmMentionsKeywordElement"
]
}
},
"nullable": true,
"type": "array",
"x-original-openapi-description": "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 examples: target array with a domain entity",
"x-required-status": "required"
}
},
"required": [
"target"
],
"type": "object",
"x-required-origin": "official_required_array_plus_explicit_unconditional_required_field_prose"
},
"maxItems": 1,
"minItems": 1,
"type": "array",
"x-openany-retail-scope": "single_native_task_per_sale_execution",
"x-openapi-version": "3.0.1",
"x-schema-origin": "official_openapi_plus_explicit_official_doc_amendments"
},
"location": "body",
"name": "body",
"nullable": false,
"pointer": "",
"required": true,
"type": "array"
}
],
"billing": {
"currency": "USD",
"mode": "rules",
"parameters": [],
"policy_version": 2,
"sale": {
"addons": [],
"base_price_micro_usd": "100000",
"max_cost_micro_usd": "1100000",
"quantities": [
{
"id": "task_errors",
"label": "任务错误数必须为零",
"max_quantity": "0",
"measure": "value",
"pointer": "/tasks_error",
"price_micro_usd": "0",
"quantity_scale": 0,
"source": "response",
"unit": "task_error",
"unit_quantity": "1"
},
{
"id": "returned_results",
"label": "本次返回结果",
"max_quantity": "1000",
"measure": "value",
"pointer": "/tasks/0/result/0/items_count",
"price_micro_usd": "1000",
"quantity_scale": 0,
"source": "response",
"unit": "result",
"unit_quantity": "1"
}
],
"rounding": "ceil",
"variants": []
}
},
"examples": [
{
"http_status": 200,
"name": "Official example · 官方历史成对样例(未运行)",
"request": {
"body": [
{
"exclude_brand_categories": [
"insurance"
],
"filters": [
[
"brand_category",
"like",
"%comp%"
]
],
"include_brand_categories": [
"company"
],
"initial_dataset_filters": [
[
"is_web_search_based",
"=",
true
]
],
"internal_list_limit": 5,
"language_code": "en",
"limit": 5,
"location_code": 2840,
"offset": 0,
"order_by": [
"total.mentions,desc"
],
"platform": "chat_gpt",
"target": [
{
"keyword": "bmw",
"search_filter": "include",
"search_scope": [
"answer"
]
}
]
}
],
"headers": {},
"path": {},
"query": {}
},
"response_body": {
"cost": 0.101,
"status_code": 20000,
"status_message": "Ok.",
"tasks": [
{
"cost": 0.101,
"data": {
"api": "ai_optimization",
"exclude_brand_categories": [
"insurance"
],
"filters": [
[
"brand_category",
"like",
"%comp%"
]
],
"function": "top_mentioned_brand_categories",
"include_brand_categories": [
"company"
],
"initial_dataset_filters": [
[
"is_web_search_based",
"=",
true
]
],
"internal_list_limit": 5,
"language_code": "en",
"limit": 5,
"location_code": 2840,
"offset": 0,
"order_by": [
"total.mentions,desc"
],
"platform": "chat_gpt",
"target": [
{
"keyword": "bmw",
"search_filter": "include",
"search_scope": [
"answer"
]
}
]
},
"id": "06241340-1444-0656-0000-241dab846eef",
"path": [
"v3",
"ai_optimization",
"llm_mentions",
"top_mentioned_brand_categories",
"live"
],
"result": [
{
"aggregated_metrics": {
"brand_entities_category": [
{
"ai_search_volume": 157351,
"key": "company",
"mentions": 3253
},
{
"ai_search_volume": 52846,
"key": "vehicle",
"mentions": 720
},
{
"ai_search_volume": 13388,
"key": "brand",
"mentions": 254
},
{
"ai_search_volume": 9864,
"key": "people",
"mentions": 187
},
{
"ai_search_volume": 3758,
"key": "organization",
"mentions": 102
}
],
"brand_entities_title": [
{
"ai_search_volume": 12274,
"key": "BMW",
"mentions": 412
},
{
"ai_search_volume": 21354,
"key": "German automaker",
"mentions": 397
},
{
"ai_search_volume": 5057,
"key": "Mercedes-Benz",
"mentions": 209
},
{
"ai_search_volume": 16851,
"key": "German luxury automaker",
"mentions": 195
},
{
"ai_search_volume": 24707,
"key": "Japanese automaker",
"mentions": 185
}
],
"language": [
{
"ai_search_volume": 157351,
"key": "en",
"mentions": 3253
}
],
"location": [
{
"ai_search_volume": 157351,
"key": 2840,
"mentions": 3253
}
],
"platform": [
{
"ai_search_volume": 157351,
"key": "chat_gpt",
"mentions": 3253
}
],
"search_results_domain": [
{
"ai_search_volume": 17016,
"key": "carinterior.alibaba.com",
"mentions": 372
},
{
"ai_search_volume": 12772,
"key": "www.motortrend.com",
"mentions": 341
},
{
"ai_search_volume": 14738,
"key": "www.alibaba.com",
"mentions": 340
},
{
"ai_search_volume": 25687,
"key": "www.slashgear.com",
"mentions": 279
},
{
"ai_search_volume": 7062,
"key": "www.motor1.com",
"mentions": 197
}
],
"sources_domain": [
{
"ai_search_volume": 29323,
"key": "en.wikipedia.org",
"mentions": 790
},
{
"ai_search_volume": 44264,
"key": "www.reddit.com",
"mentions": 434
},
{
"ai_search_volume": 12531,
"key": "www.reuters.com",
"mentions": 130
},
{
"ai_search_volume": 4986,
"key": "www.caranddriver.com",
"mentions": 126
},
{
"ai_search_volume": 4494,
"key": "www.consumerreports.org",
"mentions": 102
}
],
"total": {
"ai_search_volume": 157351,
"mentions": 3253
}
},
"items": [
{
"brand_category": "company",
"brand_entities_category": [
{
"ai_search_volume": 157351,
"key": "company",
"mentions": 3253
},
{
"ai_search_volume": 52846,
"key": "vehicle",
"mentions": 720
},
{
"ai_search_volume": 13388,
"key": "brand",
"mentions": 254
},
{
"ai_search_volume": 9864,
"key": "people",
"mentions": 187
},
{
"ai_search_volume": 3758,
"key": "organization",
"mentions": 102
}
],
"brand_entities_title": [
{
"ai_search_volume": 12274,
"key": "BMW",
"mentions": 412
},
{
"ai_search_volume": 21354,
"key": "German automaker",
"mentions": 397
},
{
"ai_search_volume": 5057,
"key": "Mercedes-Benz",
"mentions": 209
},
{
"ai_search_volume": 16851,
"key": "German luxury automaker",
"mentions": 195
},
{
"ai_search_volume": 24707,
"key": "Japanese automaker",
"mentions": 185
}
],
"language": [
{
"ai_search_volume": 157351,
"key": "en",
"mentions": 3253
}
],
"location": [
{
"ai_search_volume": 157351,
"key": 2840,
"mentions": 3253
}
],
"platform": [
{
"ai_search_volume": 157351,
"key": "chat_gpt",
"mentions": 3253
}
],
"search_results_domain": [
{
"ai_search_volume": 17016,
"key": "carinterior.alibaba.com",
"mentions": 372
},
{
"ai_search_volume": 12772,
"key": "www.motortrend.com",
"mentions": 341
},
{
"ai_search_volume": 14738,
"key": "www.alibaba.com",
"mentions": 340
},
{
"ai_search_volume": 25687,
"key": "www.slashgear.com",
"mentions": 279
},
{
"ai_search_volume": 7062,
"key": "www.motor1.com",
"mentions": 197
}
],
"sources_domain": [
{
"ai_search_volume": 29323,
"key": "en.wikipedia.org",
"mentions": 790
},
{
"ai_search_volume": 44264,
"key": "www.reddit.com",
"mentions": 434
},
{
"ai_search_volume": 12531,
"key": "www.reuters.com",
"mentions": 130
},
{
"ai_search_volume": 4986,
"key": "www.caranddriver.com",
"mentions": 126
},
{
"ai_search_volume": 4494,
"key": "www.consumerreports.org",
"mentions": 102
}
],
"total": {
"ai_search_volume": 157351,
"mentions": 3253
}
}
],
"items_count": 1,
"offset": 0,
"total_count": 1
}
],
"result_count": 1,
"status_code": 20000,
"status_message": "Ok.",
"time": "1.5921 sec."
}
],
"tasks_count": 1,
"tasks_error": 0,
"time": "1.6363 sec.",
"version": "0.1.20260610"
}
}
]
}
```Error handling
| Status | Next step |
|---|---|
400 | Check the offering and request fields. |
401 / 403 | Verify your credentials and access permissions. |
402 | Inspect the selected access mode and returned payment requirements. |
429 | Respect the returned rate limit and retry guidance. |
5xx | Inspect the error and usage record before retrying a paid operation. |
Official example · 官方历史成对样例(未运行)
Example from the provider's documentation. Field values in your results will differ.
Prepare your environment
Use a terminal with cURL installed.
Use an OpenAny API key with shared-balance access. Confirm availability and price before running; a call may charge your balance.
Set the key in your terminal using the hidden prompt below. Keep its value out of source files and logs.
Terminal · macOS / Linuxprintf 'OpenAny API key: ' read -r -s OPENANY_API_KEY export OPENANY_API_KEY printf '\n'Run the request
Paste the complete command below into your terminal.
Values to replace before running 1
Review these request fields before running. Keep the published provider and request method unchanged.
body- Live LLM Mentions Top Mentioned Brand Categories endpoint provides aggregated LLM mentions metrics grouped by the most frequently mentioned brand categories for the specified target. The results are specific to the selected platform, location and language parameters (see the List of Locations & Languages).
Terminal · cURLcurl \ 'https://api.openany.si/v1/agent-apis/dataforseo/v3/ai_optimization/llm_mentions/top_mentioned_brand_categories/live' \ -X POST \ -H "Authorization: Bearer $OPENANY_API_KEY" \ -H 'Content-Type: application/json' \ --data-raw '[ { "exclude_brand_categories": [ "insurance" ], "filters": [ [ "brand_category", "like", "%comp%" ] ], "include_brand_categories": [ "company" ], "initial_dataset_filters": [ [ "is_web_search_based", "=", true ] ], "internal_list_limit": 5, "language_code": "en", "limit": 5, "location_code": 2840, "offset": 0, "order_by": [ "total.mentions,desc" ], "platform": "chat_gpt", "target": [ { "keyword": "bmw", "search_filter": "include", "search_scope": [ "answer" ] } ] } ]'Check the response
Sample response · Documented HTTP 200
Sample response{ "cost": 0.101, "status_code": 20000, "status_message": "Ok.", "tasks": [ { "cost": 0.101, "data": { "api": "ai_optimization", "exclude_brand_categories": [ "insurance" ], "filters": [ [ "brand_category", "like", "%comp%" ] ], "function": "top_mentioned_brand_categories", "include_brand_categories": [ "company" ], "initial_dataset_filters": [ [ "is_web_search_based", "=", true ] ], "internal_list_limit": 5, "language_code": "en", "limit": 5, "location_code": 2840, "offset": 0, "order_by": [ "total.mentions,desc" ], "platform": "chat_gpt", "target": [ { "keyword": "bmw", "search_filter": "include", "search_scope": [ "answer" ] } ] }, "id": "06241340-1444-0656-0000-241dab846eef", "path": [ "v3", "ai_optimization", "llm_mentions", "top_mentioned_brand_categories", "live" ], "result": [ { "aggregated_metrics": { "brand_entities_category": [ { "ai_search_volume": 157351, "key": "company", "mentions": 3253 }, { "ai_search_volume": 52846, "key": "vehicle", "mentions": 720 }, { "ai_search_volume": 13388, "key": "brand", "mentions": 254 }, { "ai_search_volume": 9864, "key": "people", "mentions": 187 }, { "ai_search_volume": 3758, "key": "organization", "mentions": 102 } ], "brand_entities_title": [ { "ai_search_volume": 12274, "key": "BMW", "mentions": 412 }, { "ai_search_volume": 21354, "key": "German automaker", "mentions": 397 }, { "ai_search_volume": 5057, "key": "Mercedes-Benz", "mentions": 209 }, { "ai_search_volume": 16851, "key": "German luxury automaker", "mentions": 195 }, { "ai_search_volume": 24707, "key": "Japanese automaker", "mentions": 185 } ], "language": [ { "ai_search_volume": 157351, "key": "en", "mentions": 3253 } ], "location": [ { "ai_search_volume": 157351, "key": 2840, "mentions": 3253 } ], "platform": [ { "ai_search_volume": 157351, "key": "chat_gpt", "mentions": 3253 } ], "search_results_domain": [ { "ai_search_volume": 17016, "key": "carinterior.alibaba.com", "mentions": 372 }, { "ai_search_volume": 12772, "key": "www.motortrend.com", "mentions": 341 }, { "ai_search_volume": 14738, "key": "www.alibaba.com", "mentions": 340 }, { "ai_search_volume": 25687, "key": "www.slashgear.com", "mentions": 279 }, { "ai_search_volume": 7062, "key": "www.motor1.com", "mentions": 197 } ], "sources_domain": [ { "ai_search_volume": 29323, "key": "en.wikipedia.org", "mentions": 790 }, { "ai_search_volume": 44264, "key": "www.reddit.com", "mentions": 434 }, { "ai_search_volume": 12531, "key": "www.reuters.com", "mentions": 130 }, { "ai_search_volume": 4986, "key": "www.caranddriver.com", "mentions": 126 }, { "ai_search_volume": 4494, "key": "www.consumerreports.org", "mentions": 102 } ], "total": { "ai_search_volume": 157351, "mentions": 3253 } }, "items": [ { "brand_category": "company", "brand_entities_category": [ { "ai_search_volume": 157351, "key": "company", "mentions": 3253 }, { "ai_search_volume": 52846, "key": "vehicle", "mentions": 720 }, { "ai_search_volume": 13388, "key": "brand", "mentions": 254 }, { "ai_search_volume": 9864, "key": "people", "mentions": 187 }, { "ai_search_volume": 3758, "key": "organization", "mentions": 102 } ], "brand_entities_title": [ { "ai_search_volume": 12274, "key": "BMW", "mentions": 412 }, { "ai_search_volume": 21354, "key": "German automaker", "mentions": 397 }, { "ai_search_volume": 5057, "key": "Mercedes-Benz", "mentions": 209 }, { "ai_search_volume": 16851, "key": "German luxury automaker", "mentions": 195 }, { "ai_search_volume": 24707, "key": "Japanese automaker", "mentions": 185 } ], "language": [ { "ai_search_volume": 157351, "key": "en", "mentions": 3253 } ], "location": [ { "ai_search_volume": 157351, "key": 2840, "mentions": 3253 } ], "platform": [ { "ai_search_volume": 157351, "key": "chat_gpt", "mentions": 3253 } ], "search_results_domain": [ { "ai_search_volume": 17016, "key": "carinterior.alibaba.com", "mentions": 372 }, { "ai_search_volume": 12772, "key": "www.motortrend.com", "mentions": 341 }, { "ai_search_volume": 14738, "key": "www.alibaba.com", "mentions": 340 }, { "ai_search_volume": 25687, "key": "www.slashgear.com", "mentions": 279 }, { "ai_search_volume": 7062, "key": "www.motor1.com", "mentions": 197 } ], "sources_domain": [ { "ai_search_volume": 29323, "key": "en.wikipedia.org", "mentions": 790 }, { "ai_search_volume": 44264, "key": "www.reddit.com", "mentions": 434 }, { "ai_search_volume": 12531, "key": "www.reuters.com", "mentions": 130 }, { "ai_search_volume": 4986, "key": "www.caranddriver.com", "mentions": 126 }, { "ai_search_volume": 4494, "key": "www.consumerreports.org", "mentions": 102 } ], "total": { "ai_search_volume": 157351, "mentions": 3253 } } ], "items_count": 1, "offset": 0, "total_count": 1 } ], "result_count": 1, "status_code": 20000, "status_message": "Ok.", "time": "1.5921 sec." } ], "tasks_count": 1, "tasks_error": 0, "time": "1.6363 sec.", "version": "0.1.20260610" }
Common questions
Do I need a separate key for every provider?
Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.
Are these providers interchangeable?
No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.
How is this API billed?
API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.
Where do the price and contract come from?
The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.
How do OpenAny Balance and x402 differ?
OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.
Does Playground send a paid request?
Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.
Use DataForSEO — Ai Optimization / Llm Mentions / Top Mentioned Brand Categories / Live with your agent
Inspect endpoint contracts and confirm availability and pricing before a paid call.