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

# get_domain_history

> A domain's Google rankings and estimated traffic month by month, years back. ₹24 per call; ₹0 only when the call fails.

## What it does

One domain's Google presence month by month: data.items[] with a row per month (year, month) and metrics.organic and metrics.paid, each with how many keywords rank in position 1 (pos_1), 2 to 3, 4 to 10 and so on to 100, the keyword count, estimated traffic value (etv) and how many keywords are new, up, down or lost, in one market.

Use it for a site that already ranks, to see whether a competitor's traffic jumped after they published something or how your own site has moved; first check with [`get_domain_overview`](https://parel.si/docs/tools/get_domain_overview.md), which is far cheaper, that the domain has rankings in that market: small or new sites usually have none here, and that answer is charged like any other but tells you nothing. [`get_ranked_keywords`](https://parel.si/docs/tools/get_ranked_keywords.md) lists the keywords themselves. The dearest SEO tool: the quote is the price of the full history since October 2020, and a shorter window costs less (the default six months about three-fifths of it), always charged at what the call really cost, never above the quote; every call needs the user's yes. Up to twenty seconds.

India: location_code 2356 with language_code "en".

## 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 | no | Last month, yyyy-mm-dd. Default today. |
| `date_from` | string | no | First month, yyyy-mm-dd, not before 2020-10-01. Default six months ago. A shorter window costs less than the quote. |
| `language_code` | string | no | Two-letter language code ("en"). |
| `location_code` | integer | no | Market as a numeric code: 2356 India, 2840 United States. |

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

## What drives the cost

Needs confirm: true, the user's yes to the quoted price. Check get_domain_overview first: a domain with no rankings there has none here either. Only a failed call is ₹0. The timeout is 60 seconds.

## Price today

| | |
|---|---|
| Price today | **₹24** per call (`cost_paise: 2368`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹35.52 (`hold_paise: 3552`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails: ₹0 |
| Timeout | 60 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "get_domain_history"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_domain_history"` |
| Confirmation | needed: send `confirm: true` after the user agrees to the quote |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_domain_history","input":{"target":"tulip.co","date_from":"2025-01-01","language_code":"en","location_code":2840}}'
```

## What comes back

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

```json
{
  "se_type": "google",
  "target": "tulip.co",
  "location_code": 2840,
  "language_code": "en",
  "total_count": 18,
  "items_count": 18,
  "items": [
    {
      "year": 2026,
      "month": 11,
      "metrics": {
        "organic": {
          "pos_1": 229,
          "pos_2_3": 476,
          "pos_4_10": 1698,
          "pos_11_20": 1574,
          "pos_21_30": 971,
          "pos_31_40": 773,
          "pos_41_50": 339,
          "pos_51_60": 179,
          "pos_61_70": 113,
          "pos_71_80": 58,
          "pos_81_90": 27,
          "pos_91_100": 9,
          "etv": 7825.85145759234,
          "count": 6446,
          "estimated_paid_traffic_cost": 373481.54376018216,
          "is_new": 2825,
          "is_up": 1596,
          "is_down": 1496,
          "is_lost": 2954
        },
        "paid": {
          "pos_1": 0,
          "pos_2_3": 0,
          "pos_4_10": 0,
          "pos_11_20": 0,
          "pos_21_30": 0,
          "pos_31_40": 0,
          "pos_41_50": 0,
          "pos_51_60": 0,
          "pos_61_70": 0,
          "pos_71_80": 0,
          "pos_81_90": 0,
          "pos_91_100": 0,
          "etv": 0,
          "count": 0,
          "estimated_paid_traffic_cost": 0,
          "is_new": 0,
          "is_up": 0,
          "is_down": 0,
          "is_lost": 0
        }
      }
    },
    {
      "year": 2026,
      "month": 10,
      "metrics": {
        "organic": {
          "pos_1": 259,
          "pos_2_3": 513,
          "pos_4_10": 1793,
          "pos_11_20": 1706,
          "pos_21_30": 1050,
          "pos_31_40": 808,
          "pos_41_50": 348,
          "pos_51_60": 186,
          "pos_61_70": 114,
          "pos_71_80": 61,
          "pos_81_90": 27,
          "pos_91_100": 10,
          "etv": 7212.809361683001,
          "count": 6875,
          "estimated_paid_traffic_cost": 45271.55304277535,
          "is_new": 2947,
          "is_up": 1735,
          "is_down": 1633,
          "is_lost": 2996
        },
        "paid": {
          "pos_1": 0,
          "pos_2_3": 0,
          "pos_4_10": 0,
          "pos_11_20": 0,
          "pos_21_30": 0,
          "pos_31_40": 0,
          "pos_41_50": 0,
          "pos_51_60": 0,
          "pos_61_70": 0,
          "pos_71_80": 0,
          "pos_81_90": 0,
          "pos_91_100": 0,
          "etv": 0,
          "count": 0,
          "estimated_paid_traffic_cost": 0,
          "is_new": 0,
          "is_up": 0,
          "is_down": 0,
          "is_lost": 0
        }
      }
    },
    {
      "year": 2026,
      "month": 9,
      "metrics": {
        "organic": {
          "pos_1": 291,
          "pos_2_3": 571,
          "pos_4_10": 1912,
          "pos_11_20": 1801,
          "pos_21_30": 1013,
          "pos_31_40": 596,
          "pos_41_50": 323,
          "pos_51_60": 194,
          "pos_61_70": 118,
          "pos_71_80": 59,
          "pos_81_90": 29,
          "pos_91_100": 10,
          "etv": 7371.411163390869,
          "count": 6917,
          "estimated_paid_traffic_cost": 53245.34705787999,
          "is_new": 2344,
          "is_up": 2125,
          "is_down": 1878,
          "is_lost": 2559
        },
        "paid": {
          "pos_1": 0,
          "pos_2_3": 0,
          "pos_4_10": 0,
          "pos_11_20": 0,
          "pos_21_30": 0,
          "pos_31_40": 0,
          "pos_41_50": 0,
          "pos_51_60": 0,
          "pos_61_70": 0,
          "pos_71_80": 0,
          "pos_81_90": 0,
          "pos_91_100": 0,
          "etv": 0,
          "count": 0,
          "estimated_paid_traffic_cost": 0,
          "is_new": 0,
          "is_up": 0,
          "is_down": 0,
          "is_lost": 0
        }
      }
    }
  ]
}
```

## Notes

- Needs confirm: true, the user's yes to the quoted price. Check get_domain_overview first: a domain with no rankings there has none here either.
- The default window is the last six months. date_from (yyyy-mm-dd, from 2020-10-01) widens it; the quote covers the full history, and a shorter window is charged less.
- A domain with no rankings in that market is charged like any other lookup: the source bills for the lookup, whatever it finds. Slow: up to twenty seconds.

## Siblings

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