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

# get_backlink_changes

> How many backlinks and referring domains a domain gained and lost each month. ₹3.05 per call; a result that finds nothing is ₹0.

## What it does

The new and lost [`backlinks`](https://parel.si/docs/tools/backlinks.md) of one domain between two dates, month by month: data.items[] with a row per month giving its date, new_backlinks, lost_backlinks, new_referring_domains, lost_referring_domains and the same for main domains.

Use it to see who is gaining links fast, whether a launch or a campaign brought links, or when a burst of spam links arrived; [`backlinks`](https://parel.si/docs/tools/backlinks.md) gives today's totals, [`list_backlinks`](https://parel.si/docs/tools/list_backlinks.md) and [`list_referring_domains`](https://parel.si/docs/tools/list_referring_domains.md) the links and the sites themselves. Priced per call, which covers the whole history (about six years of months: shorter ranges cost slightly less, charged at the real cost); a domain with no link changes in the range, or one the index does not know, is free. Under two seconds.

India: works for any domain, including .in.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `target` | string | one of | The domain, without https:// or www ("tulip.co"). |
| `date_to` | string | one of | Last day, yyyy-mm-dd. Needed. |
| `date_from` | string | one of | First day, yyyy-mm-dd. Needed. |
| `include_subdomains` | boolean | no | false to leave out subdomains. Default true. |

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

## What drives the cost

target, date_from and date_to are all needed (the source refuses a call without an end date, free). One row per month. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹3.05** per call (`cost_paise: 305`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹4.58 (`hold_paise: 458`); 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_backlink_changes"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_backlink_changes"` |
| 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_backlink_changes","input":{"target":"tulip.co","date_to":"2026-11-18","date_from":"2026-01-01"}}'
```

## What comes back

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

```json
{
  "target": "tulip.co",
  "date_from": "2026-01-01",
  "date_to": "2026-11-18",
  "group_range": "month",
  "items_count": 11,
  "items": [
    {
      "date": "2026-01-31 00:00:00 +00:00",
      "new_backlinks": 7379,
      "lost_backlinks": 7935,
      "new_referring_domains": 149,
      "lost_referring_domains": 87,
      "new_referring_main_domains": 121,
      "lost_referring_main_domains": 81
    },
    {
      "date": "2026-02-28 00:00:00 +00:00",
      "new_backlinks": 765,
      "lost_backlinks": 3141,
      "new_referring_domains": 125,
      "lost_referring_domains": 86,
      "new_referring_main_domains": 82,
      "lost_referring_main_domains": 80
    },
    {
      "date": "2026-03-31 00:00:00 +00:00",
      "new_backlinks": 561,
      "lost_backlinks": 1394,
      "new_referring_domains": 152,
      "lost_referring_domains": 94,
      "new_referring_main_domains": 109,
      "lost_referring_main_domains": 87
    }
  ]
}
```

## Notes

- target, date_from and date_to are all needed (the source refuses a call without an end date, free). One row per month.
- Counts, not the links themselves: list_backlinks for those.
- A domain with no link changes in the range is free.

## Siblings

- [`backlinks`](https://parel.si/docs/tools/backlinks.md)
- [`list_backlinks`](https://parel.si/docs/tools/list_backlinks.md)
- [`list_referring_domains`](https://parel.si/docs/tools/list_referring_domains.md)
