linkedin-ad-library/
search

按公司、公司 ID 或关键词搜索公开 LinkedIn 广告,并使用国家和日期筛选,返回标准化广告主、创意、投放、目标链接、展示次数和媒体字段。

LinkedIn Ad Library Search API

公司与关键词搜索
每页 24 条
公开广告披露
每条结果 0.5 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

LinkedIn Ad Library Search

LinkedIn Ad Library Search 通过公司名称、精确公司 ID、关键词或这些输入的组合,发现仍可检索的公开广告披露。返回记录会标准化来源提供的广告主身份、创意文本、详情 URL、投放时间、国家、展示次数、格式、目标链接和媒体,并且不会把缺失披露字段当作零。

LinkedIn Ad Library Search API 主要特性

  • 三种发现输入可使用公司名称、关键词、精确 LinkedIn 公司 ID,或在一个请求中组合这些字段;至少要提供其中一个。
  • 国家与日期筛选通过两位国家代码和可选的 YYYY-MM-DD 投放日期区间缩小公开索引范围。
  • 标准化公开广告记录在来源披露时返回稳定的广告身份、广告主、创意、详情 URL、日期、市场、格式、目标链接、展示次数和媒体字段。
  • 有界令牌分页以 24 的倍数请求 24 到 1,992 条记录,SocQ 会继续使用新的上游分页令牌,直到达到上限或没有下一可用页。
  • 从搜索进入详情当某条搜索结果需要可用的详情记录时,可把返回的 /ad-library/detail/ URL 交给 LinkedIn Ad Library Ad。

LinkedIn Ad Library Search API 参数

参数必填描述
company必填(至少一项)公司或广告主名称。company、keyword 和 company_id 至少需要一个。
keyword必填(至少一项)用于公开广告搜索的文本,具体匹配规则由公开来源决定。
company_id必填(至少一项)作为搜索输入的精确 LinkedIn 公司 ID。
countries可选可选两位字母国家代码列表,建议使用大写形式,例如 US 和 CA。
start_date可选可选公开投放日期筛选起点,格式为 YYYY-MM-DD。
end_date可选可选公开投放日期筛选终点,格式为 YYYY-MM-DD,且不能早于 start_date。
results_limit可选请求的最大记录数。默认 24,可设置为 24 到 1,992 之间且为 24 倍数的整数。

如何使用 LinkedIn Ad Library Search API

至少选择一个发现字段,只添加用于定义样本的筛选条件,然后读取异步任务的完整结果页。

  1. 提供 company、keyword 或 company_id;只有确实需要更窄的来源匹配时才组合多个字段。
  2. 可选添加两位 countries、有效日期区间,以及 24 的倍数 results_limit。
  3. 向 /v1/linkedin-ad-library/search POST 请求并保存返回的 task_id。
  4. 轮询 /v1/tasks/{task_id},读取 data.results.items,并在 has_more 为 true 时继续使用 next_cursor。
curl -X POST "https://api.socq.ai/v1/linkedin-ad-library/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"Microsoft","countries":["US"],"results_limit":24}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items,并在 has_more 为 true 时继续使用 next_cursor

LinkedIn Ad Library Search API 最佳使用场景

  • 发现广告主公开广告: 使用公司名称或精确公司 ID,整理采集时可观察到的该广告主公开广告。
  • 文案与主题研究: 搜索产品、竞品或主题关键词,对比返回的创意文本、格式、媒体和目标链接。
  • 市场与时间窗口比较: 使用一致查询和受控国家、日期筛选重复采集,对比定义明确的公开披露样本。
  • 选择详情候选: 根据返回的广告 ID 和详情 URL,挑选需要交给独立详情接口进一步查看的记录。

LinkedIn Ad Library Search API 使用建议

  • 先从一个发现字段开始;只有需要更窄的来源匹配结果时,才组合 company、keyword 和 company_id。
  • 虽然当前校验器接受大小写字母,但建议使用大写国家代码,以保持保存输入一致。
  • 以每 24 条为一个增量设置 results_limit,并把它视为采集上限,而不是结果数量承诺。
  • 比较多次采集时保留查询、筛选条件和 collected_at,因为公开可用性和保留记录会变化。
  • 广告主、日期、国家、展示次数、目标链接、格式或媒体为空时,应视为披露数据不可用,而不是零。

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

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

探索其他平台

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

LinkedIn Ad Library Search API — 常见问题

LinkedIn Ad Library Search API 是一个用于通过公司名称、精确公司 ID、关键词或受支持组合发现仍可检索公开 LinkedIn 广告的 API。它以 SocQ 标准化广告结构返回可用字段。

company、keyword 或 company_id 至少提供一个。可以同时提交多个字段,但其具体匹配和交集行为由上游公开搜索决定。

接口接受两位国家代码列表,以及可选 start_date 和 end_date。当前没有公开排序参数。

记录可包含广告和广告主身份、公开详情 URL、创意文本、开始与结束日期、国家、标量展示次数、格式、版位、目标链接、媒体和采集时间。

采集时可能没有仍可检索的公开广告匹配提交的发现字段和筛选条件。空结果不能证明该广告主从未投放广告。

上游每页最多返回 24 条广告。SocQ 会继续使用新的分页令牌,直到达到 results_limit、最后一页、空页、缺少令牌或令牌重复。

每条返回的标准化广告消耗 0.5 SocQ 积分;成功但没有返回记录的任务不产生结果费用。