Pay-per-call ad history research via SpyFu's Cloud Ad History API v2, settled on Tempo L2.
What it does
This MPP endpoint exposes SpyFu's Cloud Ad History API v2 through the Tempo payment protocol. SpyFu is a well-known competitive intelligence platform offering SEO rankings, PPC ad data, ad history, and domain analytics with over 18 years of historical data. This particular endpoint focuses on ad history research, allowing callers to look up historical paid-search ad creatives and related metadata for domains or keywords.
The endpoint is live and responds with a standard MPP 402 payment challenge. It settles via the Tempo method (pathUSD on Tempo L2, chain ID 4217) with a per-call charge of $0.03 (30,000 base units at 6 decimals). The fee payer flag is set to true, meaning the service covers transaction fees. Payments are directed to recipient address 0xca4e835F803cB0b7C428222B3A3B98518d4779Fe.
No OpenAPI schema, documentation pages, or usage examples were found on the MPP gateway itself — all auxiliary routes (docs, pricing, README) return 404. The underlying SpyFu Cloud Ad History API v2 is a known product, but the exact request/response schema for this MPP-wrapped version is not documented in the crawl material. Callers familiar with SpyFu's public API conventions can likely pass domain or keyword parameters in the wildcard path segment, but specifics must be confirmed externally.
Capabilities
Use cases
- —Retrieve historical PPC ad creatives for a competitor's domain
- —Analyze ad copy evolution over time for specific keywords
- —Feed ad history data into automated competitive intelligence pipelines
- —Audit a domain's paid search advertising strategy across years of data
Fit
Best for
- —AI agents performing automated competitive PPC research
- —SEO/SEM analysts needing programmatic access to ad history
- —Marketing automation workflows that require historical ad creative data
Not for
- —Organic SEO-only research with no interest in paid ads
- —Users who need a free or trial-tier ad research tool
- —Real-time ad bidding or ad serving
Quick start
curl -i https://spyfu.mpp.tempo.xyz/apis/cloud_ad_history_api/v2/{domain_or_endpoint}
# Returns 402 with WWW-Authenticate: Payment header.
# Complete the Tempo payment challenge to receive ad history data.Endpoint
Quality
The endpoint is live and returns a valid MPP 402 challenge with clear pricing, but there is no OpenAPI schema, no documentation, no examples, and no crawlable content on the gateway. The underlying SpyFu API is well-known, but the exact request/response contract for this MPP wrapper is undocumented in the available material.
Warnings
- —No documentation, OpenAPI schema, or usage examples found on the MPP gateway — all doc routes return 404.
- —Request and response schemas are unknown; the wildcard path structure is not documented.
- —Currency token address 0x20c0…8b50 on chain 4217 is assumed to be pathUSD (6 decimals) based on Tempo conventions but could not be independently verified from crawl data.
Citations
- —SpyFu offers competitor keyword research, SEO rankings, PPC ads, ad history, and domain analytics with 18+ years of historical data.https://spyfu.mpp.tempo.xyz
- —Endpoint returns HTTP 402 with a valid MPP payment challenge (method=tempo, intent=charge, amount=30000, chainId=4217).https://spyfu.mpp.tempo.xyz/apis/cloud_ad_history_api/v2/*