{"uid":"cap_735xTpgmtL3mP8_ihnDxg","slug":"spyfu-b5bf8898","name":"SpyFu Term Ad History API","description":"GET /apis/cloud_ad_history_api/v2/term/getTermAdHistory","url":"https://spyfu.x402.paysponge.com/apis/cloud_ad_history_api/v2/term/getTermAdHistory","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","additionalProperties":true}},"additionalProperties":false}},"additionalProperties":false},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rHr5c1-oCGSjzaL_Jhlo2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x036CbD53842c5426634e7929541eC2318f3dCF7e","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves the historical paid search (PPC) ad history for a specific search term or keyword via SpyFu","exampleAgentPrompt":"Show me the full paid ad history for the search term 'project management software' — I want to see which advertisers have run PPC ads on it over time and for how long.","exampleUseCases":[{"title":"Competitive bidding strategy research","prompt":"I'm analyzing our main competitors in the fitness app space. Can you pull the paid ad history for keywords like 'best workout app' and 'fitness tracking software' so I can see which companies keep bidding on them and how their ad strategies have evolved?"},{"title":"Identify emerging market opportunities","prompt":"Show me the paid search ad history for 'AI project management tools' — I want to understand which advertisers are entering this space, when they started running ads, and whether the competition level is increasing."},{"title":"Validate keyword investment decisions","prompt":"Before we commit budget to bidding on 'commercial cleaning software', I need to see the historical PPC data for that term. Who's been advertising on it consistently, and can you show me the timeline of when major players entered and exited?"}],"resultDescription":"Returns historical paid search ad data for the specified keyword/term, including which advertisers ran ads, the ad copy used, date ranges of activity, and related PPC campaign metrics sourced from SpyFu's database.","failureModes":["Missing or empty term parameter returns an error","Term with no ad history returns empty result set","Invalid or unrecognized query parameter returns 400","Payment failure via x402 returns 402 Payment Required","Rate limiting may return 429 Too Many Requests","SpyFu backend unavailability returns 503"],"whenToPreferThis":"Use this endpoint when you need historical PPC/paid search advertising data for a specific keyword or search term — particularly to understand advertiser trends, competitive bidding history, or how ad activity on a term has changed over time. Prefer this over organic or SERP endpoints when the focus is on paid search history rather than organic rankings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:51:34.944Z","isFirstParty":false}