rank_check
Where a site ranks on Google for one keyword in one place: position, title, URL and snippet for the top ten. ₹0.29 per keyword; an empty result list is ₹0.
What it does
Live Google organic results for one keyword in one location and language, from the desktop (default) or mobile SERP, in data.items[]: rank_absolute (the position on the page), rank_group, domain, title, description, url and breadcrumb, with data.items_count, data.se_results_count and data.check_url (the Google URL that was fetched). Use it to check where a site ranks for a keyword in a market and who is above it; for general searching use search_web, for Trends use keyword_data.
India: location_code 2356 (or location_name "India") with language_code "en" or "hi"; 2840 is the United States.
Inputs
Generated from the contract captured from staging on 2026-11-05.
| Field | Type | Required | Description |
|---|---|---|---|
os | string | no | windows/macos for desktop, android/ios for mobile |
depth | integer | no | results to return, default 10, max 200 — billed per 10 results. e.g. 10; max 10 |
device | string | no | desktop (default) | mobile |
keyword | string | yes | up to 700 chars; advanced search operators multiply the price by 5. e.g. "coffee" |
language_code | string | yes | one of language_code | language_name. e.g. "en" |
location_code | integer | yes | one of location_code | location_name | location_coordinate; 2840 = United States. e.g. 2840 |
location_name | string | no | alternative to location_code, e.g. "United States" |
What drives the cost
The price is per started block of ten results, and depth is capped at 10 here, so one call is one block. Advanced search operators in the keyword (site:, inurl:) multiply the source's price by five and can be refused by the per-call cost cap as estimate_too_low, ₹0: do not use them. Slow: ten to twenty-five seconds is normal.
Price today
| Price today | ₹0.29 per keyword (cost_paise: 29) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.44 (hold_paise: 44); 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 | 60 s, then upstream_timeout (₹0, retryable) |
| Over MCP | run_tool with tool: "rank_check" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "rank_check" |
| 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":"rank_check","input":{"depth":10,"keyword":"best credit card india","language_code":"en","location_code":2356}}'
What comes back
data is the result object for the keyword, with the rows in data.items[]. A real answer recorded during the live check of 2026-10-28, trimmed to two items:
{
"keyword": "best credit card india",
"type": "organic",
"se_domain": "google.com",
"location_code": 2356,
"language_code": "en",
"check_url": "https://www.google.com/search?q=best%20credit%20card%20india&hl=en&gl=IN&ie=UTF-8&uule=w+CAIQICIFSW5kaWE",
"datetime": "2026-10-28 11:24:52 +00:00",
"spell": null,
"refinement_chips": null,
"item_types": [
"ai_overview",
"organic",
"… 2 more item(s) truncated"
],
"se_results_count": 105,
"pages_count": 1,
"items_count": 9,
"items": [
{
"type": "organic",
"rank_group": 1,
"rank_absolute": 2,
"page": 1,
"domain": "cardmaven.in",
"title": "Best Credit Cards In India: Reviews & Comparisons – Card ...",
"description": "Card Maven helps you pick the right credit card for how you actually spend. We've reviewed close to 100 Indian credit cards from SBI, HDFC Bank, Axis Bank, ... Read more",
"url": "https://cardmaven.in/",
"breadcrumb": "https://cardmaven.in"
},
{
"type": "organic",
"rank_group": 2,
"rank_absolute": 3,
"page": 1,
"domain": "www.cardexpert.in",
"title": "Best Credit Cards",
"description": "20+ Best Credit Cards in India. Cashback, airport lounge access, free hotel nights, business and first class redemptions, I've analysed 250+ credit cards in ...",
"url": "https://www.cardexpert.in/category/best-credit-cards/",
"breadcrumb": "https://www.cardexpert.in › category › best-credit-cards"
},
"… 7 more item(s) truncated"
]
}
Notes
- Slow: 10 to 25 s is normal; the timeout allows more.
- depth above 10 is refused as invalid_input (free). Advanced search operators multiply the price: do not use them.
- India: location_code 2356 (or location_name "India"), language_code "en" or "hi".
Siblings
keyword_volumefor how many people search the keyword.keyword_datafor whether interest is rising.backlinksfor the strength of the sites above you.
This page as Markdown: /docs/tools/rank_check.md. Something wrong or missing: hello@parel.si.