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, for its links backlinks.
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
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:
{
"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_checkfor today's live position on one of them.get_keyword_ideasto grow the list.
This page as Markdown: /docs/tools/get_ranked_keywords.md. Something wrong or missing: hello@parel.si.