For AI

Agent skill · okdata-ads

Ad creatives

What ads are competitors running?

Searches each ad library you pick for a brand or keyword, as one table with a platform column: advertiser, headline, copy, format, first and last shown, link.

  • 2 platforms
  • 2 calls in the example
  • ≤ $0.008 for that run
  • 6 calls before it asks

Tell your AI

Install the okdata skill okdata-ads from https://okdata.online/.well-known/agent-skills/okdata-ads/SKILL.md into your skills folder.

The package is one folder with one SKILL.md; unzip it into your agent's skills folder. The skill is free; you pay only for the calls it makes.

Ask it like this

  • “What running shoe ads are on Meta and TikTok right now? Group them by the promise they make.”
  • “Which offers is this brand pushing in its Facebook and Instagram ads?”
  • “Show me the TikTok ads for portable blenders and how long each has run.”

Example run

EndpointCallsAt most
meta.ads.search1$0.004
tiktok.ads.search1$0.004
Total2$0.008

What it does

  1. Plans and states the cost before the first paid call, and asks before going past 6 calls.
  2. On each chosen ad library, call its ad search with the brand or keyword as query, one page each.
  3. Lays every result out as one table and answers from it, with the cost and where the data came from.

What you get back

PlatformAdvertiserHeadlineCopyFormatFirst shownLast shownLink

One row per item fetched. A cell stays empty when the platform does not show that figure; nothing is guessed.

Inputs it needs

InputNeededMeaning
platformsyesPlatform ids, comma-separated, e.g. douyin,weibo.
queryyesThe brand or keyword.

Platforms and endpoints

PlatformEndpointPrice
TikTokTikTok Ads Library search tiktok.ads.search$0.004 per call · about 12 ads per page
Meta Ad LibraryMeta Ad Library search meta.ads.search$0.004 per call · about 30 ads per page

Connect once, then just ask.

Every new key comes with $0.10 to try it. One sentence connects your agent.

Start free
Connect your AI

Paste this into your agent

Read https://okdata.online/agents.md and set up okdata for me; my key is in the OKDATA_API_KEY environment variable.

Claude Code, Cursor, Codex and other agents that can open a link set themselves up from it.

MCP serverhttps://api.okdata.online/mcp