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

# list_referring_domains

> The domains linking to a target, each with its link count, dofollow count and authority. ₹2.02 for the largest call (100 domains); fewer settles lower.

## What it does

The referring domains of `target` (`mode` domain, host or url), in `data.refdomains[]`: `refdomain`, `backlinks`, `dofollow_backlinks`, `domain_inlink_rank` and `first_seen`, up to `limit` (100 here). Use it to see which sites link to a competitor and are worth approaching; for the individual links [`list_backlinks`](https://parel.si/docs/tools/list_backlinks.md), for totals [`backlinks`](https://parel.si/docs/tools/backlinks.md).

India: any domain.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `mode` | string | no | domain \| host \| url |
| `limit` | integer | no | How many domains to return, 1 to 100. Each domain returned is charged.; max 100 |
| `target` | string | yes | domain, host or URL. e.g. "another route" |
| `order_by` | string | no |  |

## What drives the cost

`limit`: per domain returned, so the price shown is for the largest call (100 domains); `limit: 10` settles far lower. Usually one to two seconds.

## Price today

| | |
|---|---|
| Price today | **₹2.02** per call (`cost_paise: 202`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹3.03 (`hold_paise: 303`); 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: "list_referring_domains"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "list_referring_domains"` |
| 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":"list_referring_domains","input":{"mode":"domain","limit":20,"target":"zomato.com"}}'
```

## What comes back

`data.refdomains[]`. A real answer recorded during the live check of 2026-10-28, trimmed to two domains:

```json
{
  "refdomains": [
    {
      "refdomain": "linkbuildingprovider.online",
      "backlinks": 1,
      "dofollow_backlinks": 1,
      "domain_inlink_rank": 4,
      "first_seen": "2026-10-28"
    },
    {
      "refdomain": "linkbuildingplatform.store",
      "backlinks": 1,
      "dofollow_backlinks": 1,
      "domain_inlink_rank": 2,
      "first_seen": "2026-10-28"
    },
    "… 8 more item(s) truncated"
  ]
}
```

## Notes

- Per domain: the shown price is the maximum at limit 100; smaller limits settle lower.
- order_by sorts (by backlinks or domain_inlink_rank).
- Usually one to two seconds.

## Siblings

- [`get_domain_authority`](https://parel.si/docs/tools/get_domain_authority.md) to rate any of them.
- [`list_backlinks`](https://parel.si/docs/tools/list_backlinks.md) for the links themselves.
