AI visibilityGET$0.18
/v1/ai-mentions-trend
Monthly AI mentions and AI search volume for a domain, with month-over-month deltas — prompt tracking without a tracker.
Stateless: no tracker to create, no schedule, nothing to poll. One call returns the whole series from the index start (2025-08) with mentionsChange and mentionsChangePct computed here rather than bought as a second vendor call. A jump from a zero month reports null for the percentage rather than Infinity.
Parameters#
| Name | Description | |
|---|---|---|
domain | required | hostname to track, e.g. example.com |
from | optional | start date yyyy-mm-dd (earlier than 2025-08-01 is clamped to it) |
to | optional | end date yyyy-mm-dd |
platform | optional | chat_gpt or google (default: both) |
Request#
Plain GET. Without a payment header the response is a 402 carrying the price; an x402 client pays and retries on its own — see the quickstart.
GET https://citable.run/v1/ai-mentions-trend?domain=profound.com
Response#
200 with the JSON below (trimmed) and the settlement signature in the PAYMENT-RESPONSE header. Every paid response also carries price and cluster.
{
"domain": "profound.com",
"months": [
{ "month": "2025-08", "mentions": 1, "aiSearchVolume": 10, "mentionsChange": null, "mentionsChangePct": null },
{ "month": "2025-09", "mentions": 0, "aiSearchVolume": 0, "mentionsChange": -1, "mentionsChangePct": -100 },
{ "month": "2025-10", "mentions": 0, "aiSearchVolume": 0, "mentionsChange": 0, "mentionsChangePct": null },
{ "month": "2025-11", "mentions": 2, "aiSearchVolume": 20, "mentionsChange": 2, "mentionsChangePct": null },
"…",
{ "month": "2026-07", "mentions": 2, "aiSearchVolume": 20, "mentionsChange": 2, "mentionsChangePct": null },
{ "month": "2026-08", "mentions": 3, "aiSearchVolume": 30, "mentionsChange": 1, "mentionsChangePct": 50 }
],
"summary": { "totalMentions": 22, "firstMonth": "2025-08", "lastMonth": "2026-08", "latestMentions": 3, "previousMentions": 2, "change": 1, "changePct": 50, "direction": "up" },
"coverage": { "platforms": ["chat_gpt", "google"], "indexStart": "2025-08-01", "note": "Monthly buckets from an aggregated AI-answer index; ChatGPT rows are United States / English only" },
"source": "dataforseo_llm_mentions",
"price": "$0.18",
"cluster": "mainnet"
}Errors#
Any non-200 cancels the payment — errors are free.
| Status | Code | When |
|---|---|---|
| 400 | invalid_domain | domain is not a hostname |
| 400 | invalid_date | from or to is not yyyy-mm-dd |
| 400 | invalid_platform | platform is not chat_gpt or google |
| 502 | upstream_failed | the data source did not answer — nothing is charged |
| 503 | not_configured | this deployment has no credentials for the source — nothing is charged |
MCP tool#
The same call from Claude, Codex or Cursor once citable-mcp is installed. Arguments mirror the parameters above.
citable_ai_mentions_trend(domain, from?, to?, platform?) $0.18Source & latency#
| Data source | Typical latency |
|---|---|
| DataForSEO LLM Mentions index | ~1 s |