Get ad history
Google ad copy a domain or keyword has used over time.
GET https://cotlet.dev/api/v1/spyfu/ad-history
read
Returns the ad variations SpyFu recorded, as shown on its Ad History pages. Give a domain to see how one advertiser changed its ads, or a keyword to see which advertisers ran ads for it. Each row has the month, headline lines and description.
Parameters
| Name | Type | Description |
|---|---|---|
| domain string | string | Domain without https://. Give this or keyword. |
| keyword string | string | Keyword to look up. Give this or domain. |
Request
curl https://cotlet.dev/api/v1/spyfu/ad-history \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("spyfu", "get_ad_history")const result = await cotlet.call('spyfu', 'get_ad_history');cotlet call spyfu get_ad_historyExample response
{
"domain": "trailrunner-gear.com",
"ads": [
{
"month": "2026-09",
"keyword": "trail running shoes",
"headline": "Trail Running Shoes | Free Returns",
"description": "Grip for mud and rock. Shop new arrivals."
},
{
"month": "2026-06",
"keyword": "trail running shoes",
"headline": "Trail Shoes Built for Mud",
"description": "Free shipping over a set amount. Shop now."
}
]
}