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.

FieldTypeRequiredDescription
osstringnowindows/macos for desktop, android/ios for mobile
depthintegernoresults to return, default 10, max 200 — billed per 10 results. e.g. 10; max 10
devicestringnodesktop (default) | mobile
keywordstringyesup to 700 chars; advanced search operators multiply the price by 5. e.g. "coffee"
language_codestringyesone of language_code | language_name. e.g. "en"
location_codeintegeryesone of location_code | location_name | location_coordinate; 2840 = United States. e.g. 2840
location_namestringnoalternative 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 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout60 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "rank_check"
Over RESTPOST https://api.parel.si/v1/run with "tool": "rank_check"
Confirmationnot 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

This page as Markdown: /docs/tools/rank_check.md. Something wrong or missing: hello@parel.si.