# Ad creatives: an agent skill

> What ads are competitors running? A free skill for your AI on 2 platforms: e.g. 2 calls, at most $0.008, one table back.

Canonical page: https://okdata.online/skills/ads/

**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.

## Tell your AI

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

- SKILL.md: https://okdata.online/.well-known/agent-skills/okdata-ads/SKILL.md
- Download (.zip): https://okdata.online/skills/okdata-ads.zip

## Example run

| Platform | Endpoint | Calls | At most |
|---|---|---|---|
| Meta Ad Library | [meta.ads.search](https://okdata.online/apis/meta/ads/search/) | 1 | $0.004 |
| TikTok | [tiktok.ads.search](https://okdata.online/apis/tiktok/ads/search/) | 1 | $0.004 |

Total: 2 calls, ≤ $0.008

## 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.

## What it does

1. On each chosen ad library, call its ad search with the brand or keyword as `query`, one page each.

## What you get back

Platform, Advertiser, Headline, Copy, Format, First shown, Last shown, Link

## Inputs it needs

| Input | Needed | Meaning |
|---|---|---|
| `platforms` | yes | Platform ids, comma-separated, e.g. `douyin,weibo`. |
| `query` | yes | The brand or keyword. |

## Platforms and endpoints

- TikTok: [TikTok Ads Library search](https://okdata.online/apis/tiktok/ads/search/) `tiktok.ads.search`, $0.004 per call · about 12 ads per page
- Meta Ad Library: [Meta Ad Library search](https://okdata.online/apis/meta/ads/search/) `meta.ads.search`, $0.004 per call · about 30 ads per page

The job it belongs to: [Ad intelligence API](https://okdata.online/solutions/ad-intelligence/)