{"uid":"cap_gMSnuB7g0VYD8_uNcycU_","slug":"obelisk-spy-ad-search-4e517696","name":"Obelisk Spy Ad Search","description":"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.","url":"https://api.obeliskapp.io/partner/v1/spy/ads","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9P58i8ngyWQSDguXopB1m","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Obelisk's curated competitive ad intelligence catalog by keyword, brand, or platform to retrieve ad creative examples as JSON cards","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Competitor creative research for a campaign","prompt":"Search Obelisk's spy ad catalog for ads matching the keyword 'keto diet' on TikTok and give me the first 5 results so I can see what competitors are running."},{"title":"Brand-specific ad monitoring","prompt":"Look up the latest spy ads from brand ID 'brand_12345' on Instagram — show me up to 20 results so I can track what they've been putting out."},{"title":"Cross-platform ad landscape scan","prompt":"Find me 10 example ads from Obelisk's catalog related to 'project management software' across YouTube so I can benchmark the creative styles in that space."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:32:20.386Z","isFirstParty":false}