# SpyFu Domain Ad History API

> SpyFu Domain Ad History API is a paid API for AI agents from spyfu.x402.paysponge.com, paid per call via x402, $0.010000/call, status down (last checked 2026-09-15).

Retrieves the historical paid search advertising data for a given domain, including past ad spend, keywords, and campaign history via SpyFu's Cloud Ad History API.

## Facts

- Endpoint: GET https://spyfu.x402.paysponge.com/apis/cloud_ad_history_api/v2/domain/getDomainAdHistory
- Price: $0.010000/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/spyfu-012440a0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hVZULE4NoYi6vqsLvIJMv

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability spyfu-012440a0
```

Example prompt: Pull the full ad history for hubspot.com from SpyFu — I want to see what paid search campaigns and keywords they've advertised on over time.

## When to prefer this

Use this endpoint when you need historical PPC/paid search advertising data for a specific domain, particularly for competitive intelligence, understanding a competitor's long-term advertising strategy, or researching which keywords a domain has paid for over time. Prefer this over getTermAdHistory when your research is domain-centric rather than keyword-centric.

## Known failure modes

- Domain not found or never tracked by SpyFu — returns empty result set
- Invalid domain format — returns 400 or validation error
- Payment failure via x402 — returns 402 Payment Required
- Rate limiting or quota exceeded — returns 429
- Domain has no paid ad history — returns empty data

## How this service works

GET /apis/cloud_ad_history_api/v2/domain/getDomainAdHistory

## Output

Returns historical paid search advertising data for the specified domain, including past keywords advertised on, ad copy history, estimated ad spend over time, and campaign timeline data as tracked by SpyFu.

## Request schema (JSON Schema)

```json
{
 "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
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/spyfu-012440a0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from spyfu.x402.paysponge.com](https://www.zero.xyz/host/spyfu.x402.paysponge.com/llms.txt)