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.
| 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
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.