get_ai_mentions
How often a brand or keyword is mentioned across AI answers, by model, with the sample answers. ₹11 per call; a result that finds nothing is ₹0.
What it does
How often and how prominently a brand, keyword or domain appears in AI answers: data with aggregated mention metrics for each target you name (a keyword such as a brand name, or a domain), on ChatGPT or on Google's AI answers (platform), in one market and language.
Use it as the scorecard for AI visibility work: does the brand come up, in how many answers, with what AI search volume behind the questions. get_ai_mentioned_brands says which brands come up for a topic instead, search_ai_mentions shows the answers themselves, get_ai_search_volume how often people ask AI about a keyword, and check_ai_visibility or check_claude one prompt's actual answer. Priced per call whatever the number of targets (up to ten), the dearest kind of call in the catalogue, so batch targets. Two to ten seconds.
India: location_code 2356.
Inputs
Generated from the contract captured from staging on 2026-11-05.
| Field | Type | Required | Description |
|---|---|---|---|
target | array of values | no | One to ten things to measure, each {"keyword": "mamaearth", "search_scope": ["answer"]} or {"domain": "mamaearth.in"}. |
platform | string | no | google (default): Google's AI answers, any country. chat_gpt: ChatGPT, United States and English only. |
language_code | string | no | Two-letter language code ("en"). |
location_name | string | no | A country or city ("India", "Mumbai,Maharashtra,India"). Default United States. |
What drives the cost
Priced per call for up to ten targets: put every brand you want measured in one call. A result that finds nothing is class: "ok_free", ₹0. The timeout is 90 seconds.
Price today
| Price today | ₹11 per call (cost_paise: 1139) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹17.09 (hold_paise: 1709); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0 |
| Timeout | 90 s, then upstream_timeout (₹0, retryable) |
| Over MCP | run_tool with tool: "get_ai_mentions" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "get_ai_mentions" |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |
Request
curl https://api.parel.si/v1/run \
-H "Authorization: Bearer $PAREL_KEY" \
-H "Content-Type: application/json" \
-d '{"tool":"get_ai_mentions","input":{"target":[{"keyword":"mamaearth","search_scope":["answer"]}],"platform":"google","language_code":"en","location_name":"India"}}'
What comes back
data, as the live check of 2026-11-05 recorded it, trimmed:
{
"total_count": 0,
"offset": 0,
"items_count": 0,
"aggregated_metrics": {
"location": [
{
"key": 2356,
"mentions": 5030,
"ai_search_volume": 15324510
}
],
"language": [
{
"key": "en",
"mentions": 5030,
"ai_search_volume": 15324510
}
],
"platform": [
{
"key": "google",
"mentions": 5030,
"ai_search_volume": 15324510
}
],
"sources_domain": [
{
"key": "www.google.com",
"mentions": 2981,
"ai_search_volume": 9208860
},
{
"key": "mamaearth.in",
"mentions": 1982,
"ai_search_volume": 6812940
},
{
"key": "www.youtube.com",
"mentions": 1698,
"ai_search_volume": 5574920
}
],
"search_results_domain": [],
"brand_entities_title": [],
"brand_entities_category": [],
"total": {
"mentions": 5030,
"ai_search_volume": 15324510
}
},
"items": []
}
Notes
- Priced per call for up to ten targets: put every brand you want measured in one call.
- platform chat_gpt or google; run both for the full picture. One market per call.
- Metrics are the source's aggregates over its index of AI answers, refreshed monthly, not a live run of the prompt: check_ai_visibility and check_claude do that.
- platform google works for India; ChatGPT data exists for the United States only.
Siblings
This page as Markdown: /docs/tools/get_ai_mentions.md. Something wrong or missing: hello@parel.si.