AI Mentions

DataForSEO

Measure domain or keyword visibility and cited sources in ChatGPT or Google AI results.

Capability: AI search visibility
Current price: $0.1400/call
Availability: Ready to run

What this API does

Returns DataForSEO LLM Mentions target metrics for one platform, location and language, supporting XEO visibility and citation research.

Agents select this operation with tool ID dataforseo.ai-mentions, then inspect its current executable contract before a run.

Public input and output shape

Input

domainstring · optional

Domain without protocol, path or www.

minLength: 1 · maxLength: 253

keywordstring · optional

Value supplied for keyword.

minLength: 1 · maxLength: 80

language_namestring · optional

Value supplied for language name.

minLength: 1 · maxLength: 100

location_namestring · optional

Value supplied for location name.

minLength: 1 · maxLength: 200

platformstring · optional

Value supplied for platform.

enum: chat_gpt, google

Output

aggregated_metricsobject

Returned aggregated metrics value.

items_countnumber

Returned items count value.

total_countnumber

Returned total count value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

{
  "tool_id": "dataforseo.ai-mentions",
  "input": {
    "domain": "dataforseo.com",
    "platform": "chat_gpt",
    "language_name": "English",
    "location_name": "United States"
  }
}

Output

{
  "items_count": 0,
  "total_count": 0,
  "aggregated_metrics": {
    "total": {
      "mentions": 2,
      "ai_search_volume": 18
    },
    "sources_domain": [
      {
        "key": "dataforseo.com",
        "mentions": 2,
        "ai_search_volume": 18
      }
    ],
    "search_results_domain": [
      {
        "key": "www.stork.ai",
        "mentions": 1,
        "ai_search_volume": 16
      }
    ]
  }
}

Teaching errors and limitations

configuration_error: DataForSEO account access, funding or cost controls blocked the request.Verify and fund the server-side DataForSEO API-access credentials, then retry unchanged.
invalid_input: DataForSEO rejected a target, location or bounded result control.example: {"domain":"dataforseo.com","platform":"chat_gpt","location_name":"United States","language_name":"English"}

Use AI Mentions with Scrollport

Use Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.