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

# keyword_volume_backup

> A second source for keyword_volume: google Ads monthly search volume, cost per click and competition for up to a thousand keywords in one call, by country. ₹0.27 per result; a result that finds nothing is ₹0.

## What it does

A second source for [`keyword_volume`](https://parel.si/docs/tools/keyword_volume.md), from a different data provider: google Ads monthly search volume, cost per click and competition for up to a thousand keywords in one call, by country. The answer is this provider's own, so its field names differ from [`keyword_volume`](https://parel.si/docs/tools/keyword_volume.md)'s: read the example answer, not [`keyword_volume`](https://parel.si/docs/tools/keyword_volume.md)'s docs.

Use it when [`keyword_volume`](https://parel.si/docs/tools/keyword_volume.md) fails or finds nothing; [`keyword_volume`](https://parel.si/docs/tools/keyword_volume.md) stays the first choice. It searches its own data, so it can find what the first source missed. It is a separate call at its own price: it is billed per call when it answers; a failed or empty call is free.

India: location_code 2356 with language_code "en" or "hi"; without a location the figures are worldwide.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `sort` | string | no | volume \| cpc \| difficulty \| competition |
| `source` | string | yes | regional database code — selects which country's index answers. e.g. "us" |
| `keywords` | array of string | yes | 1 to 5,000 keywords. e.g. ["seo platform"] |
| `history_to` | string | no | last month of volume history, YYYY-MM-DD |
| `sort_order` | string | no | asc \| desc |
| `history_from` | string | no | first month of volume history, YYYY-MM-DD |

## What drives the cost

Flat price per call. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.27** per result (`cost_paise: 27`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.41 (`hold_paise: 41`); 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 | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "keyword_volume_backup"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "keyword_volume_backup"` |
| 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":"keyword_volume_backup","input":{"source":"in","keywords":["protein bar","whey protein","peanut butter"]}}'
```

## What comes back

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

```json
[
  {
    "is_data_found": true,
    "keyword": "whey protein",
    "volume": 368000,
    "cpc": 0.02,
    "difficulty": 97,
    "intents": [
      "I"
    ],
    "competition": 1,
    "history_trend": {
      "2025-12-01": 301000,
      "2026-01-01": 301000,
      "2026-02-01": 301000,
      "2026-03-01": 301000,
      "2026-04-01": 301000,
      "2026-05-01": 301000,
      "2026-06-01": 301000,
      "2026-07-01": 301000,
      "2026-08-01": 301000,
      "2026-09-01": 368000,
      "2026-10-01": 368000,
      "2026-11-01": 368000
    }
  },
  {
    "is_data_found": true,
    "keyword": "protein bar",
    "volume": 90500,
    "cpc": 0.01,
    "difficulty": 68,
    "intents": [
      "I"
    ],
    "competition": 0.97,
    "history_trend": {
      "2025-12-01": 74000,
      "2026-01-01": 74000,
      "2026-02-01": 74000,
      "2026-03-01": 74000,
      "2026-04-01": 74000,
      "2026-05-01": 74000,
      "2026-06-01": 90500,
      "2026-07-01": 90500,
      "2026-08-01": 90500,
      "2026-09-01": 90500,
      "2026-10-01": 90500,
      "2026-11-01": 90500
    }
  },
  {
    "is_data_found": true,
    "keyword": "peanut butter",
    "volume": 301000,
    "cpc": 0.01,
    "difficulty": 86,
    "intents": [
      "I"
    ],
    "competition": 0.97,
    "history_trend": {
      "2025-12-01": 301000,
      "2026-01-01": 301000,
      "2026-02-01": 301000,
      "2026-03-01": 301000,
      "2026-04-01": 301000,
      "2026-05-01": 301000,
      "2026-06-01": 301000,
      "2026-07-01": 301000,
      "2026-08-01": 301000,
      "2026-09-01": 301000,
      "2026-10-01": 301000,
      "2026-11-01": 301000
    }
  }
]
```

## Notes

- Second source for keyword_volume: call keyword_volume first, this one after a failure or an empty answer.
- Field names differ from keyword_volume's; inputs keep keyword_volume's names where they mean the same thing.

## Siblings

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