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

# 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`](https://parel.si/docs/tools/search_web.md), for Trends use [`keyword_data`](https://parel.si/docs/tools/keyword_data.md).

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`](https://parel.si/docs/errors.md#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

```bash
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:

```json
{
  "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_volume`](https://parel.si/docs/tools/keyword_volume.md) for how many people search the keyword.
- [`keyword_data`](https://parel.si/docs/tools/keyword_data.md) for whether interest is rising.
- [`backlinks`](https://parel.si/docs/tools/backlinks.md) for the strength of the sites above you.
