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

# get_domain_competitors

> The sites that compete with a domain in Google, with shared keywords, average position and traffic. ₹1.63 per call; a result that finds nothing is ₹0.

## What it does

The domains that compete with one site in Google's results, found from the keywords they share: data.items[] with twenty domains, each with how many keywords it shares with the target (intersections), its average position on them, and under full_domain_metrics.organic its own keyword count, how many rank 1, 2 to 3, 4 to 10 and 11 to 20, new and lost keywords, and estimated traffic value (etv), in one market.

Use it to find rivals you did not think of, starting from your own domain; [`get_serp_competitors`](https://parel.si/docs/tools/get_serp_competitors.md) starts from a keyword list instead, [`compare_domain_keywords`](https://parel.si/docs/tools/compare_domain_keywords.md) lists the shared and missing keywords for one rival, [`get_domain_overview`](https://parel.si/docs/tools/get_domain_overview.md) sizes it. Flat price per call for twenty domains. Under seven seconds.

India: location_code 2356 with language_code "en".

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `target` | string | one of | The domain, without https:// or www ("tulip.co"). |
| `language_code` | string | no | Two-letter language code ("en"). |
| `location_code` | integer | no | Market as a numeric code: 2356 India, 2840 United States. |
| `exclude_domains` | array of string | no | Up to 50 domains to leave out of the answer. |
| `exclude_top_domains` | boolean | no | true to leave out the largest sites (Wikipedia, Amazon, YouTube and the like). |

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

## What drives the cost

Flat price per call; twenty domains per call, largest overlap first. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹1.63** per call (`cost_paise: 163`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹2.45 (`hold_paise: 245`); 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_domain_competitors"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_domain_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_domain_competitors","input":{"target":"tulip.co","language_code":"en","location_code":2840,"exclude_top_domains":true}}'
```

## What comes back

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

```json
{
  "target": "tulip.co",
  "total_count": 53873,
  "items_count": 20,
  "items": [
    {
      "domain": "tulip.co",
      "avg_position": 20.03584229390681,
      "intersections": 6138,
      "full_domain_metrics": {
        "organic": {
          "count": 6138,
          "etv": 6617.840509148082,
          "pos_1": 221,
          "pos_2_3": 456,
          "pos_4_10": 1580,
          "pos_11_20": 1494,
          "is_new": 2708,
          "is_lost": 2837
        }
      }
    },
    {
      "domain": "scribd.com",
      "avg_position": 28.658924205378973,
      "intersections": 1636,
      "full_domain_metrics": {
        "organic": {
          "count": 8209439,
          "etv": 9733985.987752944,
          "pos_1": 173146,
          "pos_2_3": 473303,
          "pos_4_10": 1987977,
          "pos_11_20": 2375870,
          "is_new": 4801952,
          "is_lost": 4435191
        }
      }
    },
    {
      "domain": "mitti.com",
      "avg_position": 22.826879271070617,
      "intersections": 1317,
      "full_domain_metrics": {
        "organic": {
          "count": 69948,
          "etv": 77729.55606660368,
          "pos_1": 1845,
          "pos_2_3": 5384,
          "pos_4_10": 17639,
          "pos_11_20": 14296,
          "is_new": 64615,
          "is_lost": 8896
        }
      }
    }
  ]
}
```

## Notes

- Flat price per call; twenty domains per call, largest overlap first.
- exclude_top_domains true leaves out the giant sites (Wikipedia, Amazon, YouTube) that overlap with everyone.
- A domain too small to have ranked keywords in that market comes back with no items, free.

## Siblings

- [`get_serp_competitors`](https://parel.si/docs/tools/get_serp_competitors.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)
