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, 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 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
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:
{
"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
This page as Markdown: /docs/tools/get_domain_history.md. Something wrong or missing: hello@parel.si.