# Ads data API

Ads data: 13 endpoints on 4 platforms in one response shape, $0.0020 per call; a failed call is free.

| Platform | Price | Endpoints |
| --- | --- | --- |
| [Google Ads API](https://dataxapi.com/apis/google/) | from $0.0020 | 3 endpoints: Ad detail, Advertiser's ads, Advertiser search |
| [LinkedIn API](https://dataxapi.com/apis/linkedin/) | from $0.0020 | 2 endpoints: Ad detail, Ad Library search |
| [Meta Ad Library API](https://dataxapi.com/apis/meta/) | from $0.0020 | 4 endpoints: Ad detail, Ad Library search, Advertiser's ads, Advertiser search |
| [TikTok API](https://dataxapi.com/apis/tiktok/) | from $0.0020 | 4 endpoints: Ads Library search, Ads Library ad detail, Top Ad detail, Top Ads search |

## The 13 endpoints

Every endpoint answers in one response shape. The Returns column names the object each one gives.

### Google Ads

| Endpoint | Path | Returns | Price |
| --- | --- | --- | --- |
| [Google ad detail](https://dataxapi.com/apis/google/ads/get.md) | `GET /v1/google/ads/get` | Ad | $0.0020 / call |
| [Google advertiser's ads](https://dataxapi.com/apis/google/advertisers/ads/list.md) | `GET /v1/google/advertisers/ads/list` | Ad list | $0.0020 / call |
| [Google advertiser search](https://dataxapi.com/apis/google/advertisers/search.md) | `GET /v1/google/advertisers/search` | Advertiser list | $0.0020 / call |

### LinkedIn

| Endpoint | Path | Returns | Price |
| --- | --- | --- | --- |
| [LinkedIn ad detail](https://dataxapi.com/apis/linkedin/ads/get.md) | `GET /v1/linkedin/ads/get` | Ad | $0.0020 / call |
| [LinkedIn Ad Library search](https://dataxapi.com/apis/linkedin/ads/search.md) | `GET /v1/linkedin/ads/search` | Ad list | $0.0020 / call |

### Meta Ad Library

| Endpoint | Path | Returns | Price |
| --- | --- | --- | --- |
| [Meta ad detail](https://dataxapi.com/apis/meta/ads/get.md) | `GET /v1/meta/ads/get` | Ad | $0.0020 / call |
| [Meta Ad Library search](https://dataxapi.com/apis/meta/ads/search.md) | `GET /v1/meta/ads/search` | Ad list | $0.0020 / call |
| [Meta advertiser's ads](https://dataxapi.com/apis/meta/advertisers/ads/list.md) | `GET /v1/meta/advertisers/ads/list` | Ad list | $0.0020 / call |
| [Meta advertiser search](https://dataxapi.com/apis/meta/advertisers/search.md) | `GET /v1/meta/advertisers/search` | Advertiser list | $0.0020 / call |

### TikTok

| Endpoint | Path | Returns | Price |
| --- | --- | --- | --- |
| [TikTok Ads Library search](https://dataxapi.com/apis/tiktok/ads/search.md) | `GET /v1/tiktok/ads/search` | Ad list | $0.0020 / call |
| [TikTok Ads Library ad detail](https://dataxapi.com/apis/tiktok/ads/get.md) | `GET /v1/tiktok/ads/get` | Ad | $0.0020 / call |
| [TikTok Creative Center Top Ad detail](https://dataxapi.com/apis/tiktok/creative_center/ads/get.md) | `GET /v1/tiktok/creative_center/ads/get` | Ad | $0.0020 / call |
| [TikTok Creative Center Top Ads search](https://dataxapi.com/apis/tiktok/creative_center/ads/search.md) | `GET /v1/tiktok/creative_center/ads/search` | Ad list | $0.0020 / call |

Prices are the prices in force. A call that fails, or whose result is uncertain, costs nothing.

## Ready to use

- [Ad creatives](https://dataxapi.com/skills/ads/): What ads are competitors running? One run: $0.0040 · 2 calls
- [The Ad object](https://dataxapi.com/docs/objects/ad/): Fields 14, Endpoints that return it 11, Platforms 4
- [The Advertiser object](https://dataxapi.com/docs/objects/advertiser/): Fields 4, Endpoints that return it 2, Platforms 2

## Questions about Ads data

### How much does it cost?

$0.0020 a call on 13 endpoints. You are charged when data comes back; a failed call costs nothing. No subscription, no monthly minimum.

### Do I need an account on the platform?

No. One DataXAPI key reads all 4 platforms. No platform account and no cookie.

### What if a platform does not have a field?

The field is left out of the item and named in `meta.unavailable` on every answer. It is never filled with a guess or a zero.

### Am I charged for an empty result?

On 8 of the 13 endpoints an empty result is charged as a call: the platform was read and had nothing to give. Each endpoint's page says which. Errors and timeouts are never charged.

### Can I see how much an advertiser spent?

No. No ad returned here says what it cost. What the libraries publish is reach: Google gives a range of total impressions where it publishes one, LinkedIn a bracket of impressions, TikTok's Ads Library a bracket of people reached; Meta's search can be sorted by impressions. TikTok's Creative Center gives likes, comments and shares.

### What is the difference between TikTok's Ads Library and the Creative Center?

The Ads Library is the transparency record of ads shown in Europe, with dates and a bracket of people reached. The Creative Center's Top Ads are a showcase of ads that did well, one country at a time, with likes and no dates. They are different sets of ads with different IDs, read by different endpoints.

### How do I get all the ads of one advertiser?

On Meta and Google, find the advertiser by name, then pass its `id` to the advertiser's ads endpoint and page on. Meta lists the ads the page is running now; Google lists 40 a page, and an ad's text and landing page come from reading the ad itself. LinkedIn and TikTok are searched by keyword.

### Do I get ads that have stopped running?

It depends on the library. Meta's search and advertiser lists return ads running now, and one Meta ad read by its ID says in `ext.active` whether it still runs. Google, LinkedIn and TikTok's Ads Library give each ad's `first_shown_at` and `last_shown_at`; for an ad still running, `last_shown_at` is when the platform last saw it.

## Other categories

[Social media](https://dataxapi.com/categories/social/), [Creators](https://dataxapi.com/categories/creator/), [E-commerce](https://dataxapi.com/categories/commerce/), [All 21 platforms →](https://dataxapi.com/apis/)

---

Last checked 2026-10-21 10:10 UTC. Catalog revision c48ce454ae6c4c65. [HTML version](https://dataxapi.com/categories/ads/)
