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.

FieldTypeRequiredDescription
targetstringone ofThe domain, without https:// or www ("tulip.co").
date_tostringnoLast month, yyyy-mm-dd. Default today.
date_fromstringnoFirst month, yyyy-mm-dd, not before 2020-10-01. Default six months ago. A shorter window costs less than the quote.
language_codestringnoTwo-letter language code ("en").
location_codeintegernoMarket 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 whenit fails: ₹0
Timeout60 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "get_domain_history"
Over RESTPOST https://api.parel.si/v1/run with "tool": "get_domain_history"
Confirmationneeded: 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.