LinkedIn Ad Library API
使用结构化搜索输入发现公开 LinkedIn 广告，再通过准确详情 URL 获取选定披露记录，用于研究、审阅和归档。
可用的 LinkedIn Ad Library API
使用 Ad Search 按公司、公司 ID 或关键词发现公开记录，使用 Ad Details 从准确公开 URL 获取一条已知记录。
可以获取哪些 LinkedIn Ad Library 数据？
SocQ 标准化公开披露字段，不会把它们表述为私有广告活动分析；来源未提供的值保持为空。
广告与广告主身份
在来源提供时获取稳定广告 ID、公开详情 URL、广告主 ID、名称、公司 URL 和徽标。
创意与目标链接信息
采集可用广告文本、格式、图片或视频资产、版位和落地页目标链接。
公开投放披露
保留来源提供的投放日期、国家、平台、展示次数和采集时间。
SocQ 与 LinkedIn Campaign Manager 对比
SocQ 采集公开 Ad Library 披露；Campaign Manager 是 LinkedIn 为获授权广告主提供的独立广告活动管理产品。
| 能力 | SocQ | LinkedIn Campaign Manager |
|---|---|---|
| 主要用途 | 发现并标准化公开广告记录 | 创建和管理已授权广告活动 |
| 输入 | 公司或关键词搜索，或一个准确详情 URL | 已授权账号和广告活动标识符 |
| 身份验证 | SocQ API key | LinkedIn 账号和广告权限 |
| 输出 | 公开披露字段 | 私有广告活动配置和报告 |
LinkedIn Ad Library API 如何工作
两个端点都使用 SocQ 的异步提交、轮询和读取流程；Search 可返回多页，Ad Details 最多返回一条记录。
1. 选择端点
向 Search 提交公司、公司 ID 或关键词，或向 Ad Details 提交一个准确的公开 Ad Library 详情 URL。
2. 提交并跟踪任务
POST 提交请求、保存 task_id，并轮询 /v1/tasks/{task_id} 直到处理结束。
3. 读取标准化记录
处理 data.results.items，并在 has_more 为 true 时继续使用 next_cursor；详情请求返回零或一条记录。
使用 SocQ API key 鉴权。Search 默认返回 24 条结果；Ad Details 接受一个准确详情 URL 且不分页。
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}'
# 或获取一条已知记录：
# POST /v1/linkedin-ad-library/ad
# {"url":"https://www.linkedin.com/ad-library/detail/666281156"}
# 轮询 GET /v1/tasks/{task_id}常见 LinkedIn Ad Library API 使用场景
发现竞品广告
查找与指定公司相关的可观察公开广告，并保留其披露背景以供复核。
创意审阅
获取选定记录并检查可用文本、媒体、格式、目标链接、广告主和投放窗口。
公开广告数据集
保存标准化广告身份、广告主、创意、投放、来源和采集字段，用于分析。
限制与公开数据边界
结果反映采集时可用的公开索引和记录可见性，不属于私有 Campaign Manager 数据。
- Search 至少需要 company、keyword 或 company_id 之一；组合多个字段时使用来源自身的匹配行为。
- countries 接受两位代码，日期必须构成有效区间，results_limit 为 24 到 1,992 之间的 24 倍数。
- 已完成搜索也可能没有记录或保留来源重复行；无法访问的详情 URL 也可能不返回记录。
- 广告主、创意、投放、展示次数、目标链接、格式和媒体字段都可能缺失，不能解释为零。
LinkedIn Ad Library API 常见问题
可以提交什么？
Search 接受公司名称、公司 ID、关键词或受支持的组合。Ad Details 接受一个准确的公开 LinkedIn Ad Library 详情 URL。
该 API 会返回私有广告活动分析吗？
不会。它只返回可用公开披露，不提供 Campaign Manager 花费、点击、转化、定向规则或账号数据。
两个端点可以返回多少条记录？
Search 默认 24 条，并接受 24 到 1,992 之间的 24 倍数。Ad Details 返回零或一条。
结果如何计费？
每条返回广告记录消耗 0.5 积分；成功但没有记录的任务不产生结果费用。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
Reddit API
通过已知 URL 获取公开 Reddit 帖子和评论，浏览 subreddit 中的 new、top 或 hot 帖子，或按关键词和发布时间搜索讨论。
Rednote API
获取公开账号和笔记，搜索笔记或用户，采集评论与嵌套回复，并记录一页首页推荐。
Pinterest API
获取公开 Pinterest 账号数据、解析指定 Pin、采集选定账号的 Pin，或按关键词搜索，用于创作者、内容和视觉趋势研究。
Threads API
获取公开 Threads 账号、解析指定帖子，或采集选定账号的帖子，并返回标准化身份、内容、媒体、互动和时间字段。
Bluesky API
获取公开 Bluesky 账号、解析指定帖子 URL，或采集一页账号帖子，并返回标准化身份、内容、媒体、时间和可见互动字段。
Snapchat API
将一个已知公开 Snapchat Spotlight 获取为标准化记录，并返回可用的创作者、说明文字、媒体、音频、时间、时长和互动字段。