给 AI

广告详情 API

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

在 Playground 里跑一次看怎么调登录后运行，用你自己的余额。

平台4 个平台

接口5 个接口有的平台不止一个

价格$0.0020 起一次。失败不收费

返回Ad（广告）一次一个对象

各平台的广告详情接口

每个接口一行：叫什么，一次返回多少，一次多少钱。

平台接口一页返回价格

TikTokTikTok 广告库广告详情GET/v1/tiktok/ads/get1广告$0.0020

TikTokTikTok 创意中心热门广告详情GET/v1/tiktok/creative_center/ads/get1广告$0.0020

LinkedInLinkedIn 广告详情GET/v1/linkedin/ads/get1广告$0.0020

Meta 广告库Meta 广告详情GET/v1/meta/ads/get1广告$0.0020

Google 广告Google 广告详情GET/v1/google/ads/get1广告$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时间最近一次投放的时间；还在投的广告是平台最近一次看到它的时间

哪个平台有哪个字段

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

平台titletextadvertiser.idadvertiser.nameadvertiser.urladvertiser.avatar_urlimagesfirst_shown_atlast_shown_at

TikTok 广告库广告详情

TikTok 创意中心热门广告详情

Meta 广告库

Google 广告

同一次调用，换一个平台

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

cURLTypeScriptPython命令行

# TikTok
curl -G "https://api.dataxapi.com/v1/tiktok/ads/get" \
  --data-urlencode "id=1871655924410641" \
  -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"

// TikTok
import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.tiktok.ads.get({ id: "1871655924410641" });
console.log(result.data.item);

// LinkedIn：只改一个词
const other = await dx.linkedin.ads.get({ id: "1588761774" });
console.log(other.data.item);

# TikTok
from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.tiktok.ads.get(id="1871655924410641")
print(result["data"]["item"])

# LinkedIn：只改一个词
other = dx.linkedin.ads.get(id="1588761774")
print(other["data"]["item"])

# TikTok
dataxapi call tiktok.ads.get id=1871655924410641

# LinkedIn：只改一个词
dataxapi call linkedin.ads.get id=1588761774

200 · application/json · 扣 $0.0020

{
  "code": "ok",
  "request_id": "3d50ccf7-9949-4da8-93fe-e3f69e907254",
  "data": {
    "item": {
      "id": "1827957127393428",
      "url": "https://library.tiktok.com/ads/detail/?ad_id=1827957127393428",
      "format": "video",
      "title": "Start weekend hiking with the kit made for beginners",
      "landing_url": "https://www.northside-roasters.com/fall?utm_source=tiktok",
      "advertiser": {
        "id": "7512826933420916016",
        "name": "Pine & Oak Home"
      },
      "images": [
        "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/d28963cc7f8ae338adda~c5_720x720.jpeg"
      ],
      "first_shown_at": "2026-10-09T00:00:00.000Z",
      "last_shown_at": "2026-10-11T00:00:00.000Z"
    }
  },
  "warnings": [],
  "meta": {
    "capability": "tiktok.ads.get",
    "result_status": "complete",
    "fetched_at": "2026-10-12T22:14:29.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "text": "capability",
      "advertiser.url": "platform",
      "advertiser.avatar_url": "platform"
    },
    "billing": {
      "amount": "0.002",
      "currency": "USD",
      "balance_after": "9.998"
    }
  }
}