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

# get_keyword_ideas_backup

> A second source for get_keyword_ideas: related keywords for a seed keyword with volume, cost per click and competition, by country. ₹0.20 per call; a result that finds nothing is ₹0.

## What it does

A second source for [`get_keyword_ideas`](https://parel.si/docs/tools/get_keyword_ideas.md), from a different data provider: related keywords for a seed keyword with volume, cost per click and competition, by country. The answer is this provider's own, so its field names differ from [`get_keyword_ideas`](https://parel.si/docs/tools/get_keyword_ideas.md)'s: read the example answer, not [`get_keyword_ideas`](https://parel.si/docs/tools/get_keyword_ideas.md)'s docs.

Use it when [`get_keyword_ideas`](https://parel.si/docs/tools/get_keyword_ideas.md) fails or finds nothing; [`get_keyword_ideas`](https://parel.si/docs/tools/get_keyword_ideas.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".

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `gl` | string | no | Two-letter country code for result localization (e.g. us, gb, de).. default "us" |
| `limit` | integer | no | Caps the result rows returned; `_truncated` says how many were withheld. Not the charge.; min 0 |
| `query` | string | yes | The partial Google search query.. e.g. "best coff" |
| `language_code` | string | no | Two-letter interface and results language code for the suggestions (e.g. en, es, de).. default "en" |

## 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.20** per call (`cost_paise: 20`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.38 (`hold_paise: 38`); 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: "get_keyword_ideas_backup"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_keyword_ideas_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":"get_keyword_ideas_backup","input":{"limit":50,"query":"best coff","language_code":"en"}}'
```

## What comes back

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

```json
{
  "query": "best coff",
  "suggestions": [
    {
      "value": "best coffee near me"
    },
    {
      "value": "best coffee maker"
    },
    {
      "value": "best coffee shops near me"
    }
  ]
}
```

## Notes

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

## Siblings

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