get_ad_history

The Google search ads a domain has run over time: the ad text, the keywords and when. ₹0.39 per ad; a result that finds nothing is ₹0.

What it does

The Google search ads one domain has run over time: data.results[] with each ad's title, body text, landing url, the keywords it ran on, its position and searchDateId (the month it was last seen, yyyymmdd), best first, for a country.

Use it to see which messages a competitor kept paying for, which shows what works for them; get_google_ads shows the ads running right now with their images and video, search_linkedin_ads and get_meta_ads the other platforms. Priced per ad returned, up to 10 a call (page_size, default 5): ask for what you need. A domain that never ran search ads is free. Under five seconds.

India: country_code IN; the default and deepest history is the United States.

Inputs

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

FieldTypeRequiredDescription
domainstringyesThe advertiser's domain ("machinemetrics.com").
sort_bystringnoBest (default), Worst, KeywordAsc, KeywordDesc or SearchDateId.
page_sizeintegernoHow many ads, 1 to 10. Default 5. The price is per ad returned.; max 10
country_codestringnoTwo letters ("US", "IN"). Default US.
keyword_filterstringnoKeep to ads that ran on keywords containing this word.

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

What drives the cost

Priced per ad returned; page_size 1 to 10, default 5. A domain with no ads is free. A result that finds nothing is class: "ok_free", ₹0. The timeout is 30 seconds.

Price today

Price today₹0.39 per ad (cost_paise: 39) at ₹93.93 per US dollar on 17 November 2026; each one asked for is charged, ₹3.39 for the largest call
Hold before the call₹0.59 (hold_paise: 59) for one, ₹5.09 for the largest call; when the call settles the real price is charged and the unused part is released
₹0 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "get_ad_history"
Over RESTPOST https://api.parel.si/v1/run with "tool": "get_ad_history"
Confirmationnot needed (the estimate is under the ₹200 threshold)
Count fieldpage_size: The hold covers the number of results you ask for in page_size; leave it out and the worst case is held.

Request

curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_ad_history","input":{"domain":"machinemetrics.com","page_size":5}}'

What comes back

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

{
  "resultCount": 3,
  "results": [
    {
      "keywords": [
        "mes",
        "mes system",
        "manufacturing execution software"
      ],
      "position": 1,
      "searchDateId": 20261101,
      "title": "MES System",
      "body": "MES System, Not a Binder — An MES system that pulls data from machines and ERP, not from operators re-typing it. 1,000...\\n[Performance Dashboards](#) · [KPI Tracking & Analysis](#) · [Integrate Systems](#) · [Automatic Data Collection](#)",
      "url": "https://www.machinemetrics.com/lp-manufacturing-execution-system",
      "adId": 1645995344
    },
    {
      "keywords": [
        "scheduling software",
        "manufacturing scheduling software",
        "manufacturing schedule software"
      ],
      "position": 2,
      "searchDateId": 20261101,
      "title": "Real-Time Prod. Scheduling",
      "body": "Schedule on Machine Truth — Deploy in days and sync your schedule to real shop floor performance. Read more\\n[Job Scheduling](#) · [Production Schedule](#) · [Real-Time Dashboards](#) · [Performance Dashboards](#)",
      "url": "https://www.machinemetrics.com/",
      "adId": -86676627
    },
    {
      "keywords": [
        "mrp system",
        "production planning program"
      ],
      "position": 2,
      "searchDateId": 20260801,
      "title": "Mfg Scheduling Software - No More Excel-Based Schedules - Pivot Without a Spreadsheet",
      "body": "Work smarter with a smart platform. Drive immediate value with MachineMetrics.",
      "url": "https://get.machinemetrics.com/production-scheduling/",
      "adId": -2002400753
    }
  ]
}

Notes

  • Priced per ad returned; page_size 1 to 10, default 5. A domain with no ads is free.
  • keyword_filter keeps to ads that ran on keywords containing a word ("pricing").
  • Each ad lists every keyword it ran on, often hundreds; keyword_filter narrows the ads, not that list. The history is deepest for the United States.

Siblings

This page as Markdown: /docs/tools/get_ad_history.md. Something wrong or missing: hello@parel.si.