linkedin-ad-library/
ad

通过准确详情 URL 获取一条公开 LinkedIn Ad Library 记录,在来源披露时返回标准化广告主、创意、投放、目标链接、展示次数和媒体字段。

LinkedIn Ad Library Ad API

准确详情 URL
公开广告披露
可空透明字段
每条结果 0.5 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

LinkedIn Ad Library Ad

LinkedIn Ad Library 详情页是曾在 LinkedIn 投放广告的有时限公开披露,在可用时包含创意、广告主、投放、目标链接、展示次数和媒体上下文。采集记录只说明当时可观察到的内容,可能随保留期、限制状态或来源条件变化而变得不完整或不可用。

LinkedIn Ad Library Ad API 主要特性

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

LinkedIn Ad Library Ad API 参数

参数必填描述
url必填必填的公开 LinkedIn Ad Library 详情 URL。协议必须是 http 或 https,主机名须以 linkedin.com 结尾,路径须包含 /ad-library/detail/。

如何使用 LinkedIn Ad Library Ad API

提交一个准确的公开 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 Ad Library Ad API 最佳使用场景

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

LinkedIn Ad Library Ad API 使用建议

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

除了 LinkedIn Ad Library Ad API,需要其他类型的 LinkedIn Ad Library 公开数据时,可以使用以下 API。

探索其他平台

还可以将 LinkedIn Ad Library 数据与其他已支持社交平台的公开数据结合使用。

LinkedIn Ad Library Ad API — 常见问题

LinkedIn Ad Library Ad API 是一个用于通过准确详情 URL 获取一条公开 LinkedIn Ad Library 记录的 API。它在公开记录披露时返回标准化广告主、创意、投放、目标链接、展示次数和媒体字段。

提交一个 linkedin.com 上的 http 或 https URL,路径须包含 /ad-library/detail/。裸 ID、公司主页、搜索 URL 和 URL 列表均不接受。

来源在部分地区可能披露更丰富的信息,但稳定契约不保证付款方身份、定向规则、国家级展示明细、行动号召或受限状态。

广告可能已移除、超过公开保留期、受到限制、来源结构异常或当前供应服务不可用。该操作不会替换为其它广告。

每条返回记录消耗 0.5 SocQ 积分。成功但为空时只收取配置为零的基础费用。