dataforseo_x_ai-optimization-llm-mentions-historical-live $0.12625 per call

Monthly LLM mention history for a keyword or domain. Live LLM Mentions Historical endpoint provides month-by-month historical metrics for mentions matching the AND-combined target filter (one series, not one per brand). (DataForSEO · AI Visibility / AEO)

POST https://toll402.dev/v1/p/dataforseo.x.ai-optimization-llm-mentions-historical-live
{
 "language_code": "es",
 "location_code": 2840,
 "platform": "google",
 "target": [
  {
   "domain": "en.wikipedia.org",
   "search_filter": "exclude"
  },
  {
   "keyword": "bmw",
   "search_scope": [
    "answer"
   ]
  }
 ]
}

Input schema

{
 "type": "object",
 "properties": {
  "target": {
   "type": "array",
   "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. All target entities are AND",
   "examples": [
    [
     {
      "domain": "en.wikipedia.org",
      "search_filter": "exclude"
     },
     {
      "keyword": "bmw",
      "search_scope": [
       "answer"
      ]
     }
    ]
   ]
  },
  "date_from": {
   "type": "string",
   "description": "start date of the time range optional field minimal value 2025-08-01 date format \"yyyy-mm-dd\""
  },
  "date_to": {
   "type": "string",
   "description": "end date of the time range optional field Note value specified in date_from cannot exceed the value in date_to date format \"yyyy-mm-dd\""
  },
  "location_name": {
   "type": "string",
   "description": "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 ta"
  },
  "location_code": {
   "type": "integer",
   "description": "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 ",
   "examples": [
    2840
   ]
  },
  "language_name": {
   "type": "string",
   "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 li"
  },
  "language_code": {
   "type": "string",
   "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://a",
   "examples": [
    "es"
   ]
  },
  "platform": {
   "type": "string",
   "description": "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; ",
   "examples": [
    "google"
   ]
  },
  "tag": {
   "type": "string",
   "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"
  }
 },
 "additionalProperties": true,
 "description": "the POST body is an ARRAY of task objects with these fields — one object per task"
}

MCP

{"mcpServers":{"toll402":{"command":"npx","args":["-y","toll402-mcp"],"env":{"TOLL402_WALLET_KEY":"0x..."}}}}

All tools · OpenAPI