AI Visibility Score
**Country-level.** These numbers come from mention tables, which are scoped to a country. A city in `location` resolves to its country and the response reports `location_scope: "country"` with the country in `location_used`. For city-level AI results use /v1/ai/scraper or /v1/serp/ai-mode. Check how visible your domain is across AI platforms for your target keywords. Get mention counts, impression estimates, and ranking among competing domains.
When to use this
You want a score that tells you how visible your website is in AI-generated answers. Think of it like a Google ranking, but for ChatGPT and Google AI. Track it monthly to see if your AI visibility is growing or shrinking.
/v1/ai/visibilityParameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| domain | string | Yes | Your domain to check |
| keywords | string[] | Yes | Keywords to check (max 10) |
| location | string | No | Location (e.g. "Austin, TX"). Default: United States |
| platforms | string[] | No | Any of ["chat_gpt", "claude", "gemini", "perplexity", "google"]. Default: all five. |
| language | string | No | ISO 639-1 code or language name ("fr", "French"). Defaults to the language we hold AI data for in that country. Asking for one we have no data for returns a 400 listing what we do have. |
Example Request
curl -X POST https://api.localseodata.com/v1/ai/visibility \
-H "Authorization: Bearer sk_live_your_key" \
-H "Content-Type: application/json" \
-d '{
"domain": "abcplumbing.com",
"keywords": ["plumber austin", "emergency plumber austin"],
"location": "Austin, Texas",
"platforms": ["chat_gpt", "google"]
}'Example Response
{
"status": "success",
"credits_used": 81,
"data": {
"domain": "abcplumbing.com",
"total_mentions": 8,
"total_impressions": 3400,
"ai_search_volume": 12500,
"platform_breakdown": {
"chat_gpt": { "mentions": 5, "ai_search_volume": 7200, "impressions": 2200 },
"google": { "mentions": 3, "ai_search_volume": 5300, "impressions": 1200 }
},
"top_sources": [
{ "domain": "yelp.com", "mentions": 12, "impressions": 8500 },
{ "domain": "homeadvisor.com", "mentions": 8, "impressions": 4200 }
]
}
}Response Fields
| Field | Type | Description |
|---|---|---|
| total_mentions | integer | Total times your domain is mentioned across all platforms |
| total_impressions | integer | Total AI impressions |
| ai_search_volume | integer | Combined AI search volume across platforms |
| platform_breakdown | object | Per-platform metrics (mentions, ai_search_volume, impressions) |
| top_sources | array | Top domains cited alongside your domain |
Notes
- This is the AI equivalent of checking your Google rankings — but for ChatGPT and Google AI.
- Run monthly to track your AI visibility over time.
- top_sources shows which domains AI considers authoritative alongside yours.