> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/get_ai_mentions

# 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`](https://parel.si/docs/tools/get_ai_mentioned_brands.md) says which brands come up for a topic instead, [`search_ai_mentions`](https://parel.si/docs/tools/search_ai_mentions.md) shows the answers themselves, [`get_ai_search_volume`](https://parel.si/docs/tools/get_ai_search_volume.md) how often people ask AI about a keyword, and [`check_ai_visibility`](https://parel.si/docs/tools/check_ai_visibility.md) or [`check_claude`](https://parel.si/docs/tools/check_claude.md) 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

```bash
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:

```json
{
  "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

- [`get_ai_mentioned_brands`](https://parel.si/docs/tools/get_ai_mentioned_brands.md)
- [`search_ai_mentions`](https://parel.si/docs/tools/search_ai_mentions.md)
- [`get_ai_search_volume`](https://parel.si/docs/tools/get_ai_search_volume.md)
- [`check_ai_visibility`](https://parel.si/docs/tools/check_ai_visibility.md)
- [`check_claude`](https://parel.si/docs/tools/check_claude.md)
