Skip to content
onelayer.
All tools

Tool detail

ads

Searches a curated catalog of competitor ad creative by keyword, brand, or platform and returns JSON ad cards.

Categories: SEO marketing

Use when

  • find competitor ad examples on TikTok or Instagram
  • search a spy-ad catalog by brand or keyword

Not for

  • catalog coverage and update frequency are not documented

Inputs

GET query params: query, brand_id, platform, limit, offset (all optional, string/integer)

Admitted input schema

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Filter by spy brand id"
    },
    "limit": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Page size; use 1 for a cheap first call"
    },
    "offset": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Pagination offset"
    },
    "platform": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Filter by platform (tiktok, facebook, instagram, youtube, x)"
    },
    "query": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional keyword filter"
    }
  },
  "required": [],
  "additionalProperties": false
}

Endpoint

Method
GET
URL
https://api.obeliskapp.io/partner/v1/spy/ads

Payment

Protocol
x402
Listed price
0.01 USDC per call on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
GET https://api.obeliskapp.io/partner/v1/spy/ads
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z