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

# get_ai_search_volume

> How often keywords are asked of AI assistants each month, next to their Google volume. ₹1.15 per call; a result that finds nothing is ₹0.

## What it does

How often people put each keyword to AI tools, as an estimated monthly AI search volume per keyword (up to 100 a call) in one market and language: data with the keywords and their volumes and trend. It is the AI-era twin of [`keyword_volume`](https://parel.si/docs/tools/keyword_volume.md) (Google's monthly searches): use the two side by side to see which questions have moved from Google to ChatGPT, and feed the winners to [`get_ai_mentioned_brands`](https://parel.si/docs/tools/get_ai_mentioned_brands.md) to see who AI recommends. Flat price per call for up to 100 keywords, so batch them. Under five seconds.

India: location_code 2356.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `keywords` | array of values | no | Up to 100 keywords. |
| `language_code` | string | no | Two-letter language code ("en"). |
| `location_code` | integer | no | Market as a numeric code: 2356 is India. |

## What drives the cost

Flat per call for up to 100 keywords: batch them. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 90 seconds.

## Price today

| | |
|---|---|
| Price today | **₹1.15** per call (`cost_paise: 115`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹1.73 (`hold_paise: 173`); 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_search_volume"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_ai_search_volume"` |
| 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_search_volume","input":{"keywords":["protein bar","whey protein","peanut butter"],"language_code":"en","location_code":2356}}'
```

## What comes back

`data`, as the live check of 2026-11-05 recorded it, trimmed:

```json
{
  "location_code": 2356,
  "language_code": "en",
  "items_count": 3,
  "items": [
    {
      "keyword": "protein bar",
      "ai_search_volume": 1131,
      "ai_monthly_searches": [
        {
          "year": 2026,
          "month": 10,
          "ai_search_volume": 1131
        },
        {
          "year": 2026,
          "month": 9,
          "ai_search_volume": 1283
        },
        {
          "year": 2026,
          "month": 8,
          "ai_search_volume": 960
        }
      ]
    },
    {
      "keyword": "whey protein",
      "ai_search_volume": 5251,
      "ai_monthly_searches": [
        {
          "year": 2026,
          "month": 10,
          "ai_search_volume": 5251
        },
        {
          "year": 2026,
          "month": 9,
          "ai_search_volume": 6154
        },
        {
          "year": 2026,
          "month": 8,
          "ai_search_volume": 4434
        }
      ]
    },
    {
      "keyword": "peanut butter",
      "ai_search_volume": 3073,
      "ai_monthly_searches": [
        {
          "year": 2026,
          "month": 10,
          "ai_search_volume": 3073
        },
        {
          "year": 2026,
          "month": 9,
          "ai_search_volume": 3851
        },
        {
          "year": 2026,
          "month": 8,
          "ai_search_volume": 3079
        }
      ]
    }
  ]
}
```

## Notes

- Flat per call for up to 100 keywords: batch them.
- An estimate from the source's model of AI tool usage, refreshed monthly; use it for relative comparisons between keywords.
- Pairs with keyword_volume (Google) and get_ai_mentioned_brands (who AI names).

## Siblings

- [`keyword_volume`](https://parel.si/docs/tools/keyword_volume.md)
- [`get_ai_mentioned_brands`](https://parel.si/docs/tools/get_ai_mentioned_brands.md)
