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

# get_ranked_keywords_backup

> A second source for get_ranked_keywords: the keywords a domain ranks for on Google with position, volume and the ranking page, by country. ₹2.02 per call; a result that finds nothing is ₹0.

## What it does

A second source for [`get_ranked_keywords`](https://parel.si/docs/tools/get_ranked_keywords.md), from a different data provider: the keywords a domain ranks for on Google with position, volume and the ranking page, by country. The answer is this provider's own, so its field names differ from [`get_ranked_keywords`](https://parel.si/docs/tools/get_ranked_keywords.md)'s: read the example answer, not [`get_ranked_keywords`](https://parel.si/docs/tools/get_ranked_keywords.md)'s docs.

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

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `url` | string | no | analyse one page instead of the whole domain |
| `cols` | string | no | comma-separated column selection |
| `type` | string | no | organic (default) \| adv — `adv` returns the paid keywords instead |
| `year` | integer | no | with `month`, returns a historical snapshot |
| `limit` | integer | no | 1 to 1,000, default 100. Pricing is flat per request, so a LARGE limit is the cheap choice here. e.g. 100 |
| `month` | integer | no | 1-12 |
| `offset` | integer | no | 1-based page number; default 1 |
| `source` | string | yes | regional database code. e.g. "us" |
| `target` | string | no | the domain to analyse — supply either domain or url. e.g. "another route" |
| `order_type` | string | no | asc \| desc (default desc) |
| `order_field` | string | no | column to sort by |
| `with_subdomains` | boolean | no | default true |

## 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 | **₹2.02** per call (`cost_paise: 202`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹3.03 (`hold_paise: 303`); 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_ranked_keywords_backup"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_ranked_keywords_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_ranked_keywords_backup","input":{"limit":50,"source":"in","target":"zomato.com"}}'
```

## What comes back

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

```json
[
  {
    "block_type": null,
    "block_position": 2,
    "keyword": "restaurant",
    "position": 1,
    "prev_pos": null,
    "volume": 9140000,
    "cpc": 0.05,
    "competition": 0.04,
    "url": "https://www.zomato.com/ncr/ghaziabad-restaurants?cft=0",
    "difficulty": 100,
    "total_sites": null,
    "traffic": 375542,
    "traffic_percent": 3.61,
    "price": 18777.1,
    "serp_features": [
      "local_pack",
      "reviews",
      "people_also_ask"
    ],
    "intents": [
      "L",
      "C"
    ]
  },
  {
    "block_type": null,
    "block_position": 1,
    "keyword": "restaurants",
    "position": 1,
    "prev_pos": null,
    "volume": 2740000,
    "cpc": 0.05,
    "competition": 0.04,
    "url": "https://www.zomato.com/ncr/faridabad-restaurants?cft=2",
    "difficulty": 100,
    "total_sites": null,
    "traffic": 352213,
    "traffic_percent": 3.38,
    "price": 17610.65,
    "serp_features": [
      "reviews",
      "images",
      "related_searches"
    ],
    "intents": [
      "I"
    ]
  },
  {
    "block_type": null,
    "block_position": 2,
    "keyword": "reaturant",
    "position": 1,
    "prev_pos": null,
    "volume": 7480000,
    "cpc": 0.05,
    "competition": 0.04,
    "url": "https://www.zomato.com/ncr/ghaziabad-restaurants?cft=0",
    "difficulty": 100,
    "total_sites": null,
    "traffic": 341769,
    "traffic_percent": 3.28,
    "price": 17088.45,
    "serp_features": [
      "local_pack",
      "reviews",
      "people_also_ask"
    ],
    "intents": [
      "L",
      "C"
    ]
  }
]
```

## Notes

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

## Siblings

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