# Obelisk Spy Ad Search

> Obelisk Spy Ad Search is a paid API for AI agents from api.obeliskapp.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Search Obelisk's curated competitive ad intelligence catalog by keyword, brand, or platform to retrieve ad creative examples as JSON cards

## Facts

- Endpoint: GET https://api.obeliskapp.io/partner/v1/spy/ads
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/obelisk-spy-ad-search-4e517696
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gMSnuB7g0VYD8_uNcycU_

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 obelisk-spy-ad-search-4e517696
```

Example prompt: Pull me the first 10 competitor ads from Obelisk's spy catalog for the keyword 'weight loss' on Facebook so I can analyze what creatives are working right now.

## When to prefer this

Use this endpoint when you need to browse or search a pre-curated catalog of competitor ad creatives filtered by keyword, brand, or specific social platform (TikTok, Facebook, Instagram, YouTube, X). It is ideal for competitive intelligence workflows where you want structured JSON ad card results quickly and cheaply — especially with limit=1 for a low-cost initial probe. Prefer this over building your own scraper or using broader social listening tools when the goal is ad creative discovery and benchmarking.

## Known failure modes

- Invalid or unknown brand_id returns empty results or error
- Unsupported platform value returns a validation error
- Missing or malformed query parameters may return an empty result set
- Rate limiting or payment failure returns a 402 Payment Required response
- Very broad queries with no filters may return unrelated or low-relevance ads
- Offset beyond the available result set returns empty array

## How this service works

Search Obelisk's curated spy ad catalog when you need competitor creative examples by keyword, brand, or platform. Returns JSON ad cards. Use limit=1 for a cheap first call.

## Output

Returns a JSON array of ad cards containing competitor ad creative details such as ad content, platform, brand information, and associated metadata for each matched ad in Obelisk's spy catalog.

## 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": {
      "limit": {
       "type": "integer",
       "description": "Page size; use 1 for a cheap first call"
      },
      "query": {
       "type": "string",
       "description": "Optional keyword filter"
      },
      "offset": {
       "type": "integer",
       "description": "Pagination offset"
      },
      "brand_id": {
       "type": "string",
       "description": "Filter by spy brand id"
      },
      "platform": {
       "type": "string",
       "description": "Filter by platform (tiktok, facebook, instagram, youtube, x)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/obelisk-spy-ad-search-4e517696/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.obeliskapp.io](https://www.zero.xyz/host/api.obeliskapp.io/llms.txt)