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

# get_ranked_keywords

> The keywords a domain or page ranks for on Google, with position, volume and the ranking URL, by country. ₹2.71 for the largest call (100 keywords); fewer settles lower.

## What it does

The keywords a `target` (a bare domain, or a full page URL) ranks for on Google in a country, in `data.items[]`, each with `keyword_data` (`keyword`, `keyword_info.search_volume`, `cpc`) and `ranked_serp_element.serp_item` (`rank_absolute`, `title`, `url`), up to `limit` (default 100 here), with `data.total_count` and `data.metrics` (keywords in the top 1, 3, 10, 100 and estimated traffic). Use it to see what a competitor's site wins on; for one keyword's live ranking [`rank_check`](https://parel.si/docs/tools/rank_check.md), for its links [`backlinks`](https://parel.si/docs/tools/backlinks.md).

India: `location_code` 2356 with `language_code` `"en"`. A domain with no rankings there returns an empty list, ₹0.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `limit` | integer | no | 1-1000; default 100. e.g. 2; max 100 |
| `offset` | integer | no | default 0 |
| `target` | string | yes | domain without scheme or www, or a full page URL. e.g. "another route" |
| `filters` | array of values | no | max 8 conditions |
| `order_by` | array of values | no | max 3 rules. Flat array of comma-separated "field,direction" strings (asc or desc). Field names match filters. Nested [["field","desc"]] (the filters-array shape) returns 40501 Invalid Field: 'order_by'.. e.g. ["keyword_data.keyword_info.search_volume,desc"] |
| `item_types` | array of values | no | SERP element types to count as ranking, e.g. ["organic","paid","featured_snippet"] |
| `language_code` | string | yes | one of language_code \| language_name; must be a language available for that location. Invalid Field language_code usually means an unsupported pair — e.g. 2076+fr fails (Brazil is pt); Morocco French is 2504+fr (also ar). e.g. "en" |
| `location_code` | integer | yes | one of location_code \| location_name; codes from the Labs locations list. 2840 = United States. 2076 is Brazil (not Morocco); Morocco is 2504. e.g. 2840 |
| `load_rank_absolute` | boolean | no | include absolute SERP position; default false |
| `historical_serp_mode` | string | no | live (default) \| lost \| all |

## What drives the cost

`limit`: per request plus a small amount per keyword returned, so the price shown is for the largest call (100 keywords); a smaller limit settles lower, and above 100 is `invalid_input`, ₹0.

## Price today

| | |
|---|---|
| Price today | **₹2.71** per call (`cost_paise: 271`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹4.07 (`hold_paise: 407`); 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"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_ranked_keywords"` |
| 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","input":{"limit":50,"target":"zomato.com","language_code":"en","location_code":2356}}'
```

## What comes back

`data.items[]`, `data.total_count`, `data.metrics`. A real answer recorded during the live check of 2026-10-28, trimmed to two keywords:

```json
{
  "se_type": "google",
  "target": "zomato.com",
  "location_code": 2356,
  "language_code": "en",
  "total_count": 364727,
  "items_count": 10,
  "metrics": {
    "organic": {
      "pos_1": 120650,
      "pos_2_3": 98436,
      "pos_4_10": 73917,
      "pos_11_20": 29024,
      "pos_21_30": 14277,
      "pos_31_40": 9658,
      "pos_41_50": 6794,
      "pos_51_60": 4336,
      "pos_61_70": 3170,
      "pos_71_80": 2189,
      "pos_81_90": 1456,
      "pos_91_100": 820,
      "etv": 141260700.7172259,
      "count": 364727,
      "estimated_paid_traffic_cost": 13557004.998464612,
      "is_new": 158379,
      "is_up": 55574,
      "is_down": 65496,
      "is_lost": 0,
      "clickstream_etv": null,
      "clickstream_gender_distribution": null,
      "clickstream_age_distribution": null
    },
    "paid": {
      "pos_1": 0,
      "pos_2_3": 0,
      "pos_4_10": 0,
      "pos_11_20": 0,
      "pos_21_30": 0,
      "pos_31_40": 0,
      "pos_41_50": 0,
      "pos_51_60": 0,
      "pos_61_70": 0,
      "pos_71_80": 0,
      "pos_81_90": 0,
      "pos_91_100": 0,
      "etv": 0,
      "count": 0,
      "estimated_paid_traffic_cost": 0,
      "is_new": 0,
      "is_up": 0,
      "is_down": 0,
      "is_lost": 0,
      "clickstream_etv": null,
      "clickstream_gender_distribution": null,
      "clickstream_age_distribution": null
    },
    "featured_snippet": null,
    "local_pack": null,
    "ai_overview_reference": null
  },
  "metrics_absolute": null,
  "items": [
    {
      "se_type": "google",
      "keyword_data": {
        "se_type": "google",
        "keyword": "0 40 hyderabad",
        "location_code": 2356,
        "language_code": "en",
        "keyword_info": {
          "se_type": "google",
          "last_updated_time": "2026-09-12 20:32:12 +00:00",
          "competition": 0.009999999776482582,
          "competition_level": "LOW",
          "cpc": 0.029999999329447746,
          "search_volume": 320,
          "low_top_of_page_bid": null,
          "high_top_of_page_bid": null,
          "categories": [
            10018,
            13414
          ],
          "monthly_searches": [
            {
              "year": 2026,
              "month": 8,
              "search_volume": 320
            },
            {
              "year": 2026,
              "month": 7,
              "search_volume": 480
            },
            "… 10 more item(s) truncated"
          ],
          "search_volume_trend": {
            "monthly": -33,
            "quarterly": 129,
            "yearly": 52
          }
        },
        "keyword_info_normalized_with_bing": null,
        "keyword_info_normalized_with_clickstream": null,
        "clickstream_keyword_info": null,
        "keyword_properties": {
          "se_type": "google",
          "core_keyword": "040 hyderabad",
          "synonym_clustering_algorithm": "text_processing",
          "keyword_difficulty": 0,
          "detected_language": "en",
          "is_another_language": false
        },
        "serp_info": {
          "se_type": "google",
          "check_url": "https://www.google.com/search?q=0%2040%20hyderabad&hl=en&gl=IN&ie=UTF-8&uule=w+CAIQICIFSW5kaWE",
          "serp_item_types": [
            "ai_overview",
            "organic",
            "… 5 more item(s) truncated"
          ],
          "se_results_count": 193,
          "last_updated_time": "2026-08-31 20:59:35 +00:00",
          "previous_updated_time": null
        },
        "avg_backlinks_info": {
          "se_type": "google",
          "backlinks": 5.099999904632568,
          "dofollow": 4,
          "referring_pages": 5,
          "referring_domains": 2.0999999046325684,
          "referring_main_domains": 2,
          "rank": 21.100000381469727,
          "main_domain_rank": 615.9000244140625,
          "last_updated_time": "2026-08-31 21:01:03 +00:00"
        },
        "search_intent_info": {
          "se_type": "google",
          "main_intent": "informational",
          "foreign_intent": null,
          "last_updated_time": "2026-04-29 03:10:16 +00:00"
        }
      },
      "ranked_serp_element": {
        "se_type": "google",
        "serp_item": {
          "se_type": "google",
          "type": "organic",
          "rank_group": 1,
          "rank_absolute": 2,
          "position": "left",
          "xpath": "/html[1]/body[1]/div[3]/div[1]/div[13]/div[2]/div[1]/div[2]/div[1]/div[1]/div[2]/div[2]/div[1]",
          "domain": "www.zomato.com",
          "title": "Zero40 Brewing, Jubilee Hills, Hyderabad",
          "url": "https://www.zomato.com/hyderabad/zero40-brewing-jubilee-hills",
          "breadcrumb": "https://www.zomato.com › ... › Jubilee Hills",
          "website_name": "Zomato",
          "is_image": true,
          "is_video": false,
          "is_featured_snippet": false,
          "is_malicious": false,
          "checks": [
            "is_image"
          ],
          "description": "Address. 271-A, Road 10, Jubilee Hills, Hyderabad · Popular Dishes. Beer Batter Fish, Cheesy Broccoli, Hefeweizen, Butter Chicken Pizza, Craft Beer, Brewed Beer ... Read more",
          "pre_snippet": null,
          "extended_snippet": "4.4(7,154)  · Price range: ₹3,500 for two people (approx.) with alcohol",
          "amp_version": false,
          "rating": {
            "rating_type": "Max5",
            "value": 4,
            "votes_count": 7154,
            "rating_max": 5
          },
          "highlighted": [
            "271-A",
            "Road 10",
            "… 2 more item(s) truncated"
          ],
          "links": null,
          "about_this_result": null,
          "main_domain": "zomato.com",
          "relative_url": "/hyderabad/zero40-brewing-jubilee-hills",
          "etv": 97.27999877929688,
          "estimated_paid_traffic_cost": 2.9184000492095947,
          "clickstream_etv": null,
          "rank_changes": {
            "previous_rank_absolute": null,
            "is_new": true,
            "is_up": false,
            "is_down": false
          },
          "backlinks_info": {
            "referring_domains": 4,
            "referring_main_domains": 4,
            "referring_pages": 24,
            "dofollow": 22,
            "backlinks": 24,
            "time_update": "2026-10-11 02:58:41 +00:00"
          },
          "rank_info": {
            "page_rank": 29,
            "main_domain_rank": 543
          }
        },
        "check_url": "https://www.google.com/search?q=0%2040%20hyderabad&hl=en&gl=IN&ie=UTF-8&uule=w+CAIQICIFSW5kaWE",
        "serp_item_types": [
          "ai_overview",
          "organic",
          "… 5 more item(s) truncated"
        ],
        "se_results_count": 193,
        "keyword_difficulty": 0,
        "is_lost": false,
        "last_updated_time": "2026-08-31 20:59:35 +00:00",
        "previous_updated_time": null
      }
    },
    {
      "se_type": "google",
      "keyword_data": {
        "se_type": "google",
        "keyword": "0 degree cafe",
        "location_code": 2356,
        "language_code": "en",
        "keyword_info": {
          "se_type": "google",
          "last_updated_time": "2026-09-13 09:45:09 +00:00",
          "competition": 0.009999999776482582,
          "competition_level": "LOW",
          "cpc": 0.05999999865889549,
          "search_volume": 1300,
          "low_top_of_page_bid": null,
          "high_top_of_page_bid": null,
          "categories": [
            10010,
            10083,
            "… 2 more item(s) truncated"
          ],
          "monthly_searches": [
            {
              "year": 2026,
              "month": 8,
              "search_volume": 1300
            },
            {
              "year": 2026,
              "month": 7,
              "search_volume": 1300
            },
            "… 10 more item(s) truncated"
          ],
          "search_volume_trend": {
            "monthly": 0,
            "quarterly": 30,
            "yearly": -19
          }
        },
        "keyword_info_normalized_with_bing": null,
        "keyword_info_normalized_with_clickstream": null,
        "clickstream_keyword_info": null,
        "keyword_properties": {
          "se_type": "google",
          "core_keyword": null,
          "synonym_clustering_algorithm": "text_processing",
          "keyword_difficulty": 2,
          "detected_language": "en",
          "is_another_language": false
        },
        "serp_info": {
          "se_type": "google",
          "check_url": "https://www.google.com/search?q=0%20degree%20cafe&hl=en&gl=IN&ie=UTF-8&uule=w+CAIQICIFSW5kaWE",
          "serp_item_types": [
            "local_pack",
            "organic",
            "… 4 more item(s) truncated"
          ],
          "se_results_count": 137,
          "last_updated_time": "2026-09-16 16:27:31 +00:00",
          "previous_updated_time": "2026-06-04 13:19:42 +00:00"
        },
        "avg_backlinks_info": {
          "se_type": "google",
          "backlinks": 17.399999618530273,
          "dofollow": 8.5,
          "referring_pages": 12.199999809265137,
          "referring_domains": 5.699999809265137,
          "referring_main_domains": 5.599999904632568,
          "rank": 63,
          "main_domain_rank": 541.7999877929688,
          "last_updated_time": "2026-09-16 16:27:32 +00:00"
        },
        "search_intent_info": {
          "se_type": "google",
          "main_intent": "navigational",
          "foreign_intent": null,
          "last_updated_time": "2026-04-25 03:27:42 +00:00"
        }
      },
      "ranked_serp_element": {
        "se_type": "google",
        "serp_item": {
          "se_type": "google",
          "type": "organic",
          "rank_group": 1,
          "rank_absolute": 4,
          "position": "left",
          "xpath": "/html[1]/body[1]/div[3]/div[1]/div[13]/div[2]/div[1]/div[2]/div[1]/div[1]/div[2]/div[1]/div[1]",
          "domain": "www.zomato.com",
          "title": "Xero Degrees, Connaught Place, New Delhi",
          "url": "https://www.zomato.com/ncr/xero-degrees-connaught-place-new-delhi",
          "breadcrumb": "https://www.zomato.com › ncr › xero-degrees-connaug...",
          "website_name": "Zomato",
          "is_image": true,
          "is_video": false,
          "is_featured_snippet": false,
          "is_malicious": false,
          "checks": [
            "is_image"
          ],
          "description": "Address. L-23/9, Middle Circle, Connaught Place, New Delhi · Popular Dishes. Raspberry Cooler, Slider Burger, Chicken Peri Peri Fries, Red Velvet Milkshake, ... Read more",
          "pre_snippet": null,
          "extended_snippet": "4.5(1,995)  · Price range: ₹1,000 for two people (approx.) Without alcohol",
          "amp_version": false,
          "rating": {
            "rating_type": "Max5",
            "value": 4,
            "votes_count": 1995,
            "rating_max": 5
          },
          "highlighted": [
            "L-23/9",
            "Middle Circle",
            "… 2 more item(s) truncated"
          ],
          "links": [
            {
              "type": "link_element",
              "title": "Read more",
              "description": null,
              "url": "https://www.zomato.com/ncr/xero-degrees-connaught-place-new-delhi#:~:text=Address,Circle%2C%20Connaught%20Place%2C%20New%20Delhi&text=Popular%20Dishes,Pasta%20Al%20Forno%2C%20Chicken%20Slider"
            }
          ],
          "about_this_result": null,
          "main_domain": "zomato.com",
          "relative_url": "/ncr/xero-degrees-connaught-place-new-delhi",
          "etv": 395.20001220703125,
          "estimated_paid_traffic_cost": 23.711999893188477,
          "clickstream_etv": null,
          "rank_changes": {
            "previous_rank_absolute": 4,
            "is_new": false,
            "is_up": false,
            "is_down": false
          },
          "backlinks_info": {
            "referring_domains": 1,
            "referring_main_domains": 1,
            "referring_pages": 1,
            "dofollow": 1,
            "backlinks": 1,
            "time_update": "2026-10-11 03:40:27 +00:00"
          },
          "rank_info": {
            "page_rank": 113,
            "main_domain_rank": 542
          }
        },
        "check_url": "https://www.google.com/search?q=0%20degree%20cafe&hl=en&gl=IN&ie=UTF-8&uule=w+CAIQICIFSW5kaWE",
        "serp_item_types": [
          "local_pack",
          "organic",
          "… 4 more item(s) truncated"
        ],
        "se_results_count": 137,
        "keyword_difficulty": 2,
        "is_lost": false,
        "last_updated_time": "2026-09-16 16:27:31 +00:00",
        "previous_updated_time": "2026-06-04 13:19:42 +00:00"
      }
    },
    "… 8 more item(s) truncated"
  ]
}
```

## Notes

- The shown price is the maximum (limit 100); a smaller limit settles lower; limit above 100 is invalid_input (free).
- India: location_code 2356, language_code "en". A domain with no rankings there returns an empty list, which is free.
- Usually one to four seconds.

## Siblings

- [`rank_check`](https://parel.si/docs/tools/rank_check.md) for today's live position on one of them.
- [`get_keyword_ideas`](https://parel.si/docs/tools/get_keyword_ideas.md) to grow the list.
