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

# get_serp_competitors

> The domains that rank most for a set of keywords, with average position and how many keywords each covers. ₹1.43 per call; a result that finds nothing is ₹0.

## What it does

Who ranks for the keywords you care about: data with the domains that appear in Google's results for your keyword set, each with how many of the keywords it ranks for, its average position, visibility and estimated traffic, in one market.

Use it to find the competitors you did not know you had; [`get_ranked_keywords`](https://parel.si/docs/tools/get_ranked_keywords.md) then lists what one of them ranks for, [`compare_domain_keywords`](https://parel.si/docs/tools/compare_domain_keywords.md) the overlap with you, [`get_domain_overview`](https://parel.si/docs/tools/get_domain_overview.md) their size. Flat price per call for up to 50 keywords and 100 domains. Under five seconds.

India: location_code 2356.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `limit` | integer | no | How many domains, up to 100.; max 100 |
| `keywords` | array of values | one of | Up to 50 keywords you care about. |
| `item_types` | array of values | no | Result types to count (["organic"]). |
| `language_code` | string | no | Two-letter language code ("en"). |
| `location_code` | integer | no | Market as a numeric code: 2356 is India. |

One of these sets must be complete (anything else is `invalid_input`, ₹0): `keywords`.

## What drives the cost

Flat per call for up to 50 keywords and 100 domains. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹1.43** per call (`cost_paise: 143`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹2.15 (`hold_paise: 215`); 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_serp_competitors"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_serp_competitors"` |
| 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_serp_competitors","input":{"limit":20,"keywords":["protein bar","whey protein india","peanut butter"],"language_code":"en","location_code":2356}}'
```

## What comes back

`data`, as the live check of 2026-11-05 recorded it, trimmed:

```json
{
  "se_type": "google",
  "seed_keywords": [
    "protein bar",
    "whey protein india",
    "peanut butter"
  ],
  "location_code": 2356,
  "language_code": "en",
  "total_count": 49,
  "items_count": 20,
  "items": [
    {
      "se_type": "google",
      "domain": "www.amazon.in",
      "avg_position": 9,
      "median_position": 7,
      "rating": 182,
      "etv": 1049.4003871211419,
      "keywords_count": 2,
      "visibility": 0.45,
      "relevant_serp_items": 2,
      "keywords_positions": {
        "whey protein india": [
          7
        ],
        "peanut butter": [
          11
        ]
      }
    },
    {
      "se_type": "google",
      "domain": "www.youtube.com",
      "avg_position": 12.5,
      "median_position": 5,
      "rating": 175,
      "etv": 3944.667361793832,
      "keywords_count": 2,
      "visibility": 0.65,
      "relevant_serp_items": 2,
      "keywords_positions": {
        "whey protein india": [
          20
        ],
        "peanut butter": [
          5
        ]
      }
    },
    {
      "se_type": "google",
      "domain": "www.myprotein.co.in",
      "avg_position": 13,
      "median_position": 2,
      "rating": 174,
      "etv": 578.7321680871283,
      "keywords_count": 2,
      "visibility": 0.9,
      "relevant_serp_items": 2,
      "keywords_positions": {
        "whey protein india": [
          2
        ],
        "peanut butter": [
          24
        ]
      }
    }
  ]
}
```

## Notes

- Flat per call for up to 50 keywords and 100 domains.
- Send the keywords that matter to you; the answer is the domains that rank for them, ranked by how many.
- Pairs with compare_domain_keywords and get_ranked_keywords.

## Siblings

- [`get_ranked_keywords`](https://parel.si/docs/tools/get_ranked_keywords.md)
- [`compare_domain_keywords`](https://parel.si/docs/tools/compare_domain_keywords.md)
- [`get_domain_overview`](https://parel.si/docs/tools/get_domain_overview.md)
