{"uid":"cap_OURLfQwzBTM6swzVVhFdt","slug":"spyfu--1b7d9dcc","name":"SpyFu Cloud Ad History API","description":"Ad history research","url":"https://spyfu.mpp.tempo.xyz/apis/cloud_ad_history_api/v2/*?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["__pentest_poisoned_at"],"properties":{"__pentest_poisoned_at":{"type":"string","description":"VULN-TEST: schema-poisoning canary — should not be here"}}},"responseSchema":{"type":"object","properties":{"__pentest_response_canary":{"type":"string","description":"VULN-TEST: response-schema poison canary"}}},"example":null,"exampleRequest":null,"tags":["seo","ppc","keyword-research","competitor-analysis","ads","data","search"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_phMbp6dyCbYAvJdGpAlTn","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"SpyFu","brandSlug":"spyfu","brandBaseUrl":"https://spyfu.com","brandDocsUrl":"https://developer.spyfu.com","whatItDoes":"Retrieves historical pay-per-click ad data for domains and keywords using SpyFu's 18+ year ad history database","exampleAgentPrompt":"Can you pull up the full ad history for hubspot.com using SpyFu — I want to see what PPC ads they've run historically and how their messaging has evolved over time?","exampleUseCases":[{"title":"Competitor ad messaging timeline","prompt":"Can you look up the PPC ad history for salesforce.com on SpyFu? I want to see how their ad copy and messaging has changed over the years and when they ramped up or pulled back on spending."},{"title":"Keyword advertising history research","prompt":"I'm researching the keyword 'project management software' — can you pull the historical Google ad data for it from SpyFu so I can see which companies have been bidding on it and what kind of ad copy has performed over time?"},{"title":"When competitor started advertising","prompt":"Can you check SpyFu's ad history for monday.com and tell me when they first started running Google ads, how long they've been at it, and whether there are any gaps where they stopped advertising?"}],"resultDescription":"Returns historical PPC ad data including ad copy variations, estimated spend, ad run dates, and keyword targeting history for the queried domain or keyword — sourced from SpyFu's 18+ year archive of Google ad data.","failureModes":["Domain not found in SpyFu database — returns empty result or 404","Rate limit exceeded — returns 429 with retry-after header","Invalid domain format — returns 400 bad request","No ad history available for the queried entity — returns empty ads array","Authentication/payment failure — returns 402 or 401"],"whenToPreferThis":"Use this endpoint when you need historical PPC advertising data — ad copy, spend estimates, and ad run timelines — for a specific domain or keyword. Prefer this over SEO or ranking endpoints when the user's question is specifically about paid search ads rather than organic rankings. Best for competitive intelligence on advertising strategy over time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-04-16T16:07:37.474Z","lastSuccessfullyRanAt":"2026-04-16T16:07:37.474Z","lastHealthCheckAt":"2026-10-10T06:38:25.316Z","isFirstParty":false,"canonicalSlug":"spyfu--1b7d9dcc"}