TikTok Ad Library API
通过 query 发现受支持的 TikTok 公开广告记录，或把一个已知广告 URL 解析为标准化字段，用于研究、审阅和归档。
可用的 TikTok Ad Library API
使用 Search 按广告主或关键词发现公开广告记录，使用 Ad Details 解析一个已知且合格的公开广告 URL。
可以获取哪些公开广告数据？
返回字段反映每条受支持记录当前暴露的公开信息；来源未提供的值保持为空。
广告与广告主标识
采集公开广告 ID、可用记录 URL、广告主名称、广告主引用和稳定资源类型。
创意与落地页
检查可用广告文案、格式、媒体引用和公开落地页 URL。
可见投放上下文
读取来源暴露的展示日期、发布时间、国家、平台、受众和展示信息。
采集上下文
为审阅队列、目录和研究数据集保留标准化来源及采集字段。
SocQ 与 TikTok 广告产品
SocQ 对受支持的公开透明度记录进行只读采集。TikTok 自有产品用途不同，包括公开库访问和授权活动管理。
| 能力 | SocQ | TikTok 广告产品 |
|---|---|---|
| 主要用途 | 搜索并规范化受支持的公开广告记录 | 根据具体产品提供公开透明度或授权活动操作 |
| 输入 | 一个广告主或关键词，或一个已知广告 URL | 控制项因具体 TikTok 界面而异 |
| 私有活动数据 | 不提供 | 需要适用账号、产品、审批和权限 |
| 操作 | 只读公开数据工作流 | Ads Manager 支持授权活动操作 |
| 响应格式 | 稳定 SocQ 广告记录 | 产品特定的原生视图或响应 |
TikTok Ad Library API 如何工作
两个端点都使用异步提交、轮询和读取流程；Search 可以采集多个来源页面，Ad Details 最多返回一条记录。
1. 选择端点
向 Search 提交一个广告主或关键词，或向 Ad Details 提交一个合格的 TikTok 公开广告 URL。
2. 轮询任务
使用返回的 task_id 请求 /v1/tasks/{task_id}，直到处理成功或失败。
3. 读取标准化记录
读取 data.results.items 和任务结果 cursor；详情请求返回零或一条广告。
使用 SocQ API key 验证身份。Search 默认返回 12 条结果；Ad Details 没有分页或 results_limit。
curl -X POST "https://api.socq.ai/v1/tiktok-ad-library/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Anysphere","results_limit":12}'
# 或解析一个已知广告 URL：
# POST /v1/tiktok-ad-library/ad
# {"url":"https://library.tiktok.com/ads/detail/?id=1871655924410641"}
# 轮询 GET /v1/tasks/{task_id}常见 TikTok Ad Library API 使用场景
品牌监测
为已知广告主名称匹配到的可用公开广告建立定期审阅集合。
创意审阅
解析选定广告并检查受支持的公开文案、广告主、格式、媒体和落地页字段。
透明度归档
保留带有展示日期和采集上下文的标准化公开广告记录。
研究数据补充
用搜索结果定位记录，再把已知公开广告 URL 转换为稳定详情字段。
限制与公开数据政策
公开广告记录取决于来源可见性、资格、地区可用性、发布延迟、保留规则以及相关 TikTok 界面暴露的字段。
- 搜索中缺少记录不能证明广告主从未投放广告，无法访问的 URL 也可能不会返回详情。
- Search 不提供国家、日期、section、语言、行业、objective、enrichment 或排序控制。
- 公开日期、受众或展示值不是私有花费、转化、归因或广告支出回报报告。
- 媒体引用可能是临时或受来源控制的，所有来源相关字段都可能为空。
TikTok Ad Library API 常见问题
SocQ 是 TikTok Ads Manager 吗？
不是。SocQ 搜索并规范化受支持的公开透明度记录；它不管理账号、活动、预算、定向或创意。
可以提交什么？
Search 接受一个广告主名称或关键词。Ad Details 接受一个合格的已知 TikTok 公开广告 URL。
每条结果都有完整广告详情吗？
没有。Search 通常返回摘要，详情查询也可能没有记录，所有来源相关字段都可能为空。
使用量如何计费？
每条返回记录消耗 0.5 个 SocQ 积分，不收取基础费用；Search 默认 12 条，Ad Details 最多返回一条。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
YouTube API
通过统一异步流程采集受支持的公开 YouTube 频道资料、视频详情、频道视频、评论、Shorts、关键词与话题标签结果和可用字幕。
X API
获取公开账号、关注者与关注列表、帖子、回复、引用帖、转发用户、搜索结果和当前趋势，用于研究和监测。
Facebook API
采集公开 Facebook Page、帖子、群组帖子、评论、关键词匹配活动和可用视频字幕，获得标准化身份、内容、来源、格式、地点、媒体、reaction、出席和互动字段。
Google Ad Library API
发现公开广告主、采集公司的创意，或通过 URL 获取一条已知 Transparency Center 创意，用于研究和审阅。
Google Maps API
发现公开地点、按已知 Maps URL 获取标准化详情，并采集带来源地点与作者上下文的公开评价。
Kwai API
获取公开 Kwai 主页、一页账号帖子或一个已知帖子，返回标准化身份、内容、媒体、时间和可见互动数据。