# Ad detail API

5 endpoints on 4 platforms return the same Ad object. One ad of a public ad library: advertiser, creative, landing page, when and where it ran. Every call costs $0.0020; a failed call is free.

## Ad detail on each platform

| Platform | Endpoint | Path | A page | Returns | Price |
| --- | --- | --- | --- | --- | --- |
| Google Ads | [Google ad detail](https://dataxapi.com/apis/google/ads/get.md) | `GET /v1/google/ads/get` | 1 | Ad | $0.0020 / call |
| LinkedIn | [LinkedIn ad detail](https://dataxapi.com/apis/linkedin/ads/get.md) | `GET /v1/linkedin/ads/get` | 1 | Ad | $0.0020 / call |
| Meta Ad Library | [Meta ad detail](https://dataxapi.com/apis/meta/ads/get.md) | `GET /v1/meta/ads/get` | 1 | Ad | $0.0020 / call |
| TikTok | [TikTok Ads Library ad detail](https://dataxapi.com/apis/tiktok/ads/get.md) | `GET /v1/tiktok/ads/get` | 1 | Ad | $0.0020 / call |
| TikTok | [TikTok Creative Center Top Ad detail](https://dataxapi.com/apis/tiktok/creative_center/ads/get.md) | `GET /v1/tiktok/creative_center/ads/get` | 1 | Ad | $0.0020 / call |

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

## The Ad object

Every endpoint above returns these fields, with the same names and types.

| Field | Type | Description |
| --- | --- | --- |
| `id` | text | ID; pass it unchanged to the ad's get endpoint |
| `url` | link | The ad's page in the platform's ad library |
| `format` | text | Format of the creative; other is a format of the platform's own |
| `title` | text | Headline |
| `text` | text | Body text |
| `landing_url` | link | Where a click on the ad leads |
| `advertiser.id` | text | Advertiser ID |
| `advertiser.name` | text | Advertiser's name |
| `advertiser.url` | link | The advertiser's page on the platform |
| `advertiser.avatar_url` | link | The advertiser's picture or logo |
| `images` | list of link | Addresses of the ad's images |
| `videos` | list of link | Addresses of the ad's videos; they expire |
| `first_shown_at` | time | When the ad was first shown |
| `last_shown_at` | time | When the ad was last shown; for an ad still running, when the platform last saw it |

[The object's own page →](https://dataxapi.com/docs/objects/ad/)

### Which platform fills which field

A field an endpoint cannot give is listed in `meta.unavailable` on every answer, so a gap is never a surprise.

| Platform | `title` | `text` | `advertiser.id` | `advertiser.name` | `advertiser.url` | `advertiser.avatar_url` | `images` | `first_shown_at` | `last_shown_at` |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| Google Ads | available | available | available | not available | not available | not available | available | available | available |
| LinkedIn | available | available | available | available | available | available | available | available | available |
| Meta Ad Library | available | available | available | available | available | available | available | available | available |
| TikTok Ads Library ad detail | available | not available | available | available | not available | not available | available | available | available |
| TikTok Creative Center Top Ad detail | not available | available | not available | available | not available | not available | not available | not available | not available |

## The same call on two platforms

Same parameter names, same paging, same answer. Only the path changes.

```bash
# Google Ads
curl -G "https://api.dataxapi.com/v1/google/ads/get" \
  --data-urlencode "id=AR16735076323512287233/CR13384474926044413953" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

# LinkedIn: one word changes
curl -G "https://api.dataxapi.com/v1/linkedin/ads/get" \
  --data-urlencode "id=1588761774" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
```

### 200 · application/json

Google ad detail: From a response recorded 2026-10-12 21:59 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up.

```jsonc
{
  "code": "ok",
  "request_id": "2c6d1a4f-a2f2-4537-b339-dfd44262a0ec",
  "data": {
    "item": {
      "id": "AR16957588921303948228/CR14623979096670259597",
      "url": "https://adstransparency.google.com/advertiser/AR16957588921303948228/creative/CR14623979096670259597",
      "format": "text",
      "title": "Weekend hiking essentials, 20% off this week only",
      "text": "Weekend hiking essentials, 20% off this week only",
      "landing_url": null,
      "advertiser": { "id": "AR12673385717193703136" },
      "images": [
        "https://tpc.googlesyndication.com/simgad/10334992425704947224",
        "https://tpc.googlesyndication.com/simgad/13598759742669398477",
        // … 1 more
      ],
      "first_shown_at": "2024-05-06T00:00:00.000Z",
      "last_shown_at": "2026-10-12T21:34:42.000Z"
    }
  },
  "warnings": [],
  "meta": {
    "capability": "google.ads.get",
    "result_status": "complete",
    "fetched_at": "2026-10-12T21:59:26.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "advertiser.name": "capability",
      "advertiser.url": "platform",
      "advertiser.avatar_url": "platform"
    },
    "billing": {
      "amount": "0.002",
      "currency": "USD",
      "balance_after": "9.998"
    }
  }
}
```

## What comes back

- [The Ad object](https://dataxapi.com/docs/objects/ad/): Fields 14, Endpoints that return it 11, Platforms 4

## Questions about the Ad detail API

### How much does it cost?

$0.0020 a call on Google Ads, LinkedIn, Meta Ad Library, TikTok. You are charged when data comes back; a failed call costs nothing. No subscription, no monthly minimum.

### Does every platform fill every field?

No. 9 of the 14 fields are missing on at least one platform; the table on this page says which. A field an endpoint cannot give is named in `meta.unavailable` on every answer, never filled with a guess.

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

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

## Other data types

[Comment replies API](https://dataxapi.com/roles/comments-replies-list/), [Hashtag posts API](https://dataxapi.com/roles/topics-posts-list/), [Trending topics API](https://dataxapi.com/roles/trends-list/), [Account profile API](https://dataxapi.com/roles/accounts-get/), [Account posts API](https://dataxapi.com/roles/accounts-posts-list/), [Comments API](https://dataxapi.com/roles/posts-comments-list/), [Post detail API](https://dataxapi.com/roles/posts-get/), [Post search API](https://dataxapi.com/roles/posts-search/), [Trending posts API](https://dataxapi.com/roles/posts-trending/), [Account search API](https://dataxapi.com/roles/accounts-search/), [Post metrics API](https://dataxapi.com/roles/posts-metrics/), [Community posts API](https://dataxapi.com/roles/communities-posts-list/), [Advertiser ads API](https://dataxapi.com/roles/advertisers-ads-list/), [Advertiser search API](https://dataxapi.com/roles/advertisers-search/), [Ad library search API](https://dataxapi.com/roles/ads-search/), [Video transcript API](https://dataxapi.com/roles/transcripts-get/), [Followers API](https://dataxapi.com/roles/accounts-followers-list/), [Community profile API](https://dataxapi.com/roles/communities-get/), [Product detail API](https://dataxapi.com/roles/products-get/), [Product reviews API](https://dataxapi.com/roles/products-reviews-list/), [Product search API](https://dataxapi.com/roles/products-search/), [Creator search API](https://dataxapi.com/roles/creators-search/), [Creator profile API](https://dataxapi.com/roles/creators-get/), [Creator audience API](https://dataxapi.com/roles/creators-audience-get/), [Creator metrics API](https://dataxapi.com/roles/creators-metrics/), [Creator posts API](https://dataxapi.com/roles/creators-posts-list/), [All 21 platforms →](https://dataxapi.com/apis/)

---

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