# 广告详情 API

4 个平台的 5 个接口返回同一种 Ad（广告）对象。公开广告库里的一条广告：广告主、素材、落地页、投放时间和地区。每次调用 $0.0020；失败不收费。

## 各平台的广告详情接口

| 平台 | 接口 | 路径 | 一页 | 返回 | 价格 |
| --- | --- | --- | --- | --- | --- |
| Google 广告 | [Google 广告详情](https://dataxapi.com/zh/apis/google/ads/get.md) | `GET /v1/google/ads/get` | 1 | 广告 | $0.0020 / 次 |
| LinkedIn | [LinkedIn 广告详情](https://dataxapi.com/zh/apis/linkedin/ads/get.md) | `GET /v1/linkedin/ads/get` | 1 | 广告 | $0.0020 / 次 |
| Meta 广告库 | [Meta 广告详情](https://dataxapi.com/zh/apis/meta/ads/get.md) | `GET /v1/meta/ads/get` | 1 | 广告 | $0.0020 / 次 |
| TikTok | [TikTok 广告库广告详情](https://dataxapi.com/zh/apis/tiktok/ads/get.md) | `GET /v1/tiktok/ads/get` | 1 | 广告 | $0.0020 / 次 |
| TikTok | [TikTok 创意中心热门广告详情](https://dataxapi.com/zh/apis/tiktok/creative_center/ads/get.md) | `GET /v1/tiktok/creative_center/ads/get` | 1 | 广告 | $0.0020 / 次 |

价格是现行价格。失败和结果不确定的调用不收费。

## Ad（广告）对象

上面每个接口返回的都是这些字段，名字和类型都一样。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `id` | 文本 | 编号，可原样传给取广告详情的接口 |
| `url` | 链接 | 这条广告在平台广告库里的页面 |
| `format` | 文本 | 素材形态；other 是平台自己的其他形式 |
| `title` | 文本 | 标题 |
| `text` | 文本 | 文案 |
| `landing_url` | 链接 | 点击后去的地址 |
| `advertiser.id` | 文本 | 广告主编号 |
| `advertiser.name` | 文本 | 广告主名称 |
| `advertiser.url` | 链接 | 广告主在平台上的主页 |
| `advertiser.avatar_url` | 链接 | 广告主的头像或标志 |
| `images` | 链接列表 | 图片素材的地址 |
| `videos` | 链接列表 | 视频素材的地址，会过期 |
| `first_shown_at` | 时间 | 开始投放的时间 |
| `last_shown_at` | 时间 | 最近一次投放的时间；还在投的广告是平台最近一次看到它的时间 |

[看这个对象的页面 →](https://dataxapi.com/zh/docs/objects/ad/)

### 哪个平台有哪个字段

接口给不了的字段，每次返回都会写在 `meta.unavailable` 里，所以缺字段不会是意外。

| 平台 | `title` | `text` | `advertiser.id` | `advertiser.name` | `advertiser.url` | `advertiser.avatar_url` | `images` | `first_shown_at` | `last_shown_at` |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| Google 广告 | 有 | 有 | 有 | 给不了 | 给不了 | 给不了 | 有 | 有 | 有 |
| LinkedIn | 有 | 有 | 有 | 有 | 有 | 有 | 有 | 有 | 有 |
| Meta 广告库 | 有 | 有 | 有 | 有 | 有 | 有 | 有 | 有 | 有 |
| TikTok 广告库广告详情 | 有 | 给不了 | 有 | 有 | 给不了 | 给不了 | 有 | 有 | 有 |
| TikTok 创意中心热门广告详情 | 给不了 | 有 | 给不了 | 有 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 |

## 同一次调用，换一个平台

同样的参数名，同样的翻页，同样的返回。变的只有路径。

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

# LinkedIn：只改一个词
curl -G "https://api.dataxapi.com/v1/linkedin/ads/get" \
  --data-urlencode "id=1588761774" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
```

### 200 · application/json

Google 广告详情：取自 2026-10-12 21:59 UTC 录下的真实返回。名字、正文和编号是示例，链接也是，都不是录到的原文（页面不展示任何人的个人信息）；数字是原样。长列表做了截断。请求号、游标和余额是示意。

```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 条
      ],
      "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"
    }
  }
}
```

## 返回的是什么

- [Ad（广告）对象](https://dataxapi.com/zh/docs/objects/ad/): 字段 14, 返回它的接口 11, 平台 4

## 关于 广告详情 API 的常见问题

### 多少钱？

Google 广告、LinkedIn、Meta 广告库、TikTok每次 $0.0020。拿到数据才扣费，失败不收。没有订阅，没有月最低消费。

### 每个平台的字段都全吗？

不全。14 个字段里有 9 个至少在一个平台上拿不到，本页的对照表写明是哪些。接口给不了的字段，每次返回都写在 `meta.unavailable` 里，不会用猜的数顶上。

### 需要平台账号吗？

不需要。一把 DataXAPI 的 Key 读这 4 个平台，不用任何平台的账号，也不用 Cookie。

## 其他数据类型

[评论回复 API](https://dataxapi.com/zh/roles/comments-replies-list/)、[话题下的内容 API](https://dataxapi.com/zh/roles/topics-posts-list/)、[热榜 API](https://dataxapi.com/zh/roles/trends-list/)、[账号资料 API](https://dataxapi.com/zh/roles/accounts-get/)、[账号作品列表 API](https://dataxapi.com/zh/roles/accounts-posts-list/)、[评论 API](https://dataxapi.com/zh/roles/posts-comments-list/)、[内容详情 API](https://dataxapi.com/zh/roles/posts-get/)、[内容搜索 API](https://dataxapi.com/zh/roles/posts-search/)、[热门内容榜 API](https://dataxapi.com/zh/roles/posts-trending/)、[账号搜索 API](https://dataxapi.com/zh/roles/accounts-search/)、[内容互动数据 API](https://dataxapi.com/zh/roles/posts-metrics/)、[社区帖子 API](https://dataxapi.com/zh/roles/communities-posts-list/)、[广告主的广告 API](https://dataxapi.com/zh/roles/advertisers-ads-list/)、[广告主搜索 API](https://dataxapi.com/zh/roles/advertisers-search/)、[广告库搜索 API](https://dataxapi.com/zh/roles/ads-search/)、[视频转文字 API](https://dataxapi.com/zh/roles/transcripts-get/)、[粉丝列表 API](https://dataxapi.com/zh/roles/accounts-followers-list/)、[社区资料 API](https://dataxapi.com/zh/roles/communities-get/)、[商品详情 API](https://dataxapi.com/zh/roles/products-get/)、[商品评价 API](https://dataxapi.com/zh/roles/products-reviews-list/)、[商品搜索 API](https://dataxapi.com/zh/roles/products-search/)、[达人搜索 API](https://dataxapi.com/zh/roles/creators-search/)、[达人资料 API](https://dataxapi.com/zh/roles/creators-get/)、[达人粉丝画像 API](https://dataxapi.com/zh/roles/creators-audience-get/)、[达人数据表现 API](https://dataxapi.com/zh/roles/creators-metrics/)、[达人作品 API](https://dataxapi.com/zh/roles/creators-posts-list/)、[全部 21 个平台 →](https://dataxapi.com/zh/apis/)

---

最后核对于 2026-10-21 11:10 UTC。目录修订号 c48ce454ae6c4c65。 [网页版](https://dataxapi.com/zh/roles/ads-get/)
