LinkedIn Ad Library Ad API

LinkedIn Ad Library Ad

主要特性

• 准确解析详情将一个路径含 /ad-library/detail/ 的 linkedin.com URL 解析为最多一条标准化公开广告记录。
• 创意与广告主上下文在稳定 SocQ 广告结构中保留可用广告身份、文本、广告主引用、格式、目标链接和媒体。
• 公开投放披露返回可用首次与最近日期、国家、展示平台和可安全标准化的单值展示次数，不重建私有定向。
• 受限记录安全处理广告主、文本、目标链接、展示次数或媒体不可用时保持为空，不推断来源隐去的信息。

参数

如何使用

提交一个准确的公开 LinkedIn Ad Library 详情 URL，跟踪异步任务，并在可用时读取标准化记录。

1. 复制一个 http 或 https LinkedIn Ad Library URL，路径必须包含 /ad-library/detail/。
2. 将 url POST 到 /v1/linkedin-ad-library/ad，并保存返回的 task_id。
3. 轮询 /v1/tasks/{task_id}，直到任务成功或失败。
4. 读取 data.results.items；详情操作最多返回一条记录，不会把不可用 URL 扩展为搜索。

curl -X POST "https://api.socq.ai/v1/linkedin-ad-library/ad" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/ad-library/detail/666281156"}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；详情操作最多返回一条记录

最佳使用场景

• 补全已发现的 LinkedIn 广告： 为一个已知公开详情 URL 获取可用创意、广告主、投放、目标链接、展示次数和媒体字段。
• 保存披露快照： 在有时限或受限公开记录变化或消失前，保存标准化记录和 collected_at。
• 比较公开创意证据： 比较选定广告的文案、格式、素材和披露投放上下文，不把记录当作广告活动表现数据。

使用建议

• 提交完整详情 URL，不要只填广告 ID、公司主页、搜索 URL 或 URL 列表。
• 区分成功但无可用记录与供应服务失败；两者都不能证明广告从未存在。
• 保留可空字段，因为受限或过期记录可能有意省略广告主、预览、付款方、文本、媒体或投放信息。
• 需要发现广告时使用 LinkedIn Ad Library Search；该操作只解析提交的准确详情 URL。

相关 API