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

# 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`](https://parel.si/docs/tools/get_google_ads.md) shows the ads running right now with their images and video, [`search_linkedin_ads`](https://parel.si/docs/tools/search_linkedin_ads.md) and [`get_meta_ads`](https://parel.si/docs/tools/get_meta_ads.md) 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.

| Field | Type | Required | Description |
|---|---|---|---|
| `domain` | string | yes | The advertiser's domain ("machinemetrics.com"). |
| `sort_by` | string | no | Best (default), Worst, KeywordAsc, KeywordDesc or SearchDateId. |
| `page_size` | integer | no | How many ads, 1 to 10. Default 5. The price is per ad returned.; max 10 |
| `country_code` | string | no | Two letters ("US", "IN"). Default US. |
| `keyword_filter` | string | no | Keep 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 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_ad_history"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_ad_history"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |
| Count field | `page_size`: The hold covers the number of results you ask for in page_size; leave it out and the worst case is held. |

## Request

```bash
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:

```json
{
  "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

- [`get_google_ads`](https://parel.si/docs/tools/get_google_ads.md)
- [`search_linkedin_ads`](https://parel.si/docs/tools/search_linkedin_ads.md)
- [`get_meta_ads`](https://parel.si/docs/tools/get_meta_ads.md)
