# Ad creatives: What ads are competitors running?

Ad creatives runs on 3 platforms: the example run makes 2 calls and costs at most $0.0040.

Searches each ad library you pick for the ads of a brand or keyword, as one table with a platform column: advertiser, title, copy, format, when it was first and last shown, link. Every page of every library is one call charged on its own.

Tell your AI:

> Install the DataXAPI skill dataxapi-ads from https://dataxapi.com/skills/dataxapi-ads.zip.

[Download the package](https://dataxapi.com/skills/dataxapi-ads.zip) · A .zip with one SKILL.md. It runs with the `dataxapi` command line.

- Example run: $0.0040 (at most. A failed call is never charged)
- Calls: 2 (with the example inputs)
- Hard ceiling: 9 calls, no run is opened above $0.0500

## Ask it like this

- What ads are running for “running shoes” on Meta and TikTok right now?
- Show me the ads for this competitor's brand in the Meta Ad Library, the longest-running first.
- Search the LinkedIn ad library for our category and group the creatives by format.

## What it does

Four steps. Only the second calls endpoints, so only the second costs money.

1. Show the plan first: Free, and needs no key: the most calls and the most money this run can come to.

```bash
dataxapi run ads platforms=meta,tiktok 'query=running shoes' pages=1 --plan
```

2. Run it, capped at that amount: Each line is one endpoint of the example run, at its listed price.

|  |  |  |
| --- | --- | --- |
| [Meta Ad Library search](https://dataxapi.com/apis/meta/ads/search/) `GET /v1/meta/ads/search` | 1 × $0.0020 | $0.0020 |
| [TikTok Ads Library search](https://dataxapi.com/apis/tiktok/ads/search/) `GET /v1/tiktok/ads/search` | 1 × $0.0020 | $0.0020 |

2 calls · at most $0.0040. A call that fails is not charged. The run stops rather than spend more than its cap.

```bash
dataxapi run ads platforms=meta,tiktok 'query=running shoes' pages=1 --yes --max-spend 0.004 --out ads.csv
```

3. Line everything up in one table: 9 columns, the same on every platform; a column a platform does not give is empty. No call, no cost.

4. Your AI reads the table and answers: What the table means is for your AI to say. It ends with where the data came from and when.

## What you get back

An illustration of the table, with the task's real columns. The names and figures in it are made up.

| Platform | Advertiser | Title | Format | First shown | Last shown |
| --- | --- | --- | --- | --- | --- |
| meta | Stride Lab | Lighter by 40 grams | video | 2026-09-02T00:00:00Z | 2026-10-12T00:00:00Z |
| meta | Northpath Running | The daily trainer, rebuilt | image | 2026-09-28T00:00:00Z | 2026-10-12T00:00:00Z |
| tiktok | Stride Lab | Run the long way home | video | 2026-10-01T00:00:00Z | 2026-10-11T00:00:00Z |

All 9 columns: `platform` (Platform), `ad_id` (Ad ID), `advertiser` (Advertiser), `title` (Title), `text` (Copy), `format` (Format), `first_shown_at` (First shown), `last_shown_at` (Last shown), `url` (Link)

## Inputs it needs

|  |  |  | Example |
| --- | --- | --- | --- |
| `platforms` | platforms, up to 3 | The ad libraries to search, at most 3 | `meta, tiktok` |
| `query` | text | A brand name or a keyword | `running shoes` |
| `pages` | integer | How many pages at most from each library; each page is a call charged on its own. 1 to 3. Default: 1 | `1` |

## Last verified run

- Date: 2026-10-13
- Platforms: Meta Ad Library, LinkedIn, TikTok
- Calls: 3
- Charged: $0.0045
- Rows: 65
- Against: the platforms, live

## Related

A ready-made Skill of [Ad creative intelligence](https://dataxapi.com/solutions/ads/)

The 3 endpoints it uses: [LinkedIn Ad Library search](https://dataxapi.com/apis/linkedin/ads/search/) ($0.0020), [Meta Ad Library search](https://dataxapi.com/apis/meta/ads/search/) ($0.0020), [TikTok Ads Library search](https://dataxapi.com/apis/tiktok/ads/search/) ($0.0020)

Platforms it runs on: [LinkedIn API](https://dataxapi.com/apis/linkedin/), [Meta Ad Library API](https://dataxapi.com/apis/meta/), [TikTok API](https://dataxapi.com/apis/tiktok/)

---

Generated from catalog revision c48ce454ae6c4c65, price book 2. [Page](https://dataxapi.com/skills/ads/)