Facebook Ad Library Company Search
Facebook Ad Library 公司候选是由 Page ID、名称、分类、国家、图片、验证值和关联 Instagram 上下文标识的广告主 Page。结合这些身份与受众信号，可以解析广告主、比较同名 Page，并在广告研究前完成可复核的 Page 选择。
主要特性
- 按公司与 Page 名称搜索提交一个非空公司、品牌或 Page 名称 query，获取该次查询返回的全部广告主 Page 候选。
- Page 身份与分类在公开记录提供时返回 Page ID、名称、派生公开 URL、分类、国家、实体类型、验证值、图片和 Page 删除状态。
- 可见 Page 与 Instagram 信号在标准化候选中保留可用 Facebook 点赞数，以及关联 Instagram username、粉丝数和验证状态。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
query | 必填 | 必填的非空公司、品牌或公开 Page 名称，用于查找广告主 Page 候选。 |
如何使用
提交一个公司或 Page 名称 query，跟踪异步任务，并检查标准化广告主 Page 候选。
- 准备一个非空公司、品牌或公开 Page 名称 query。
- 将 query POST 到 /v1/facebook-ad-library/company-search，并保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或失败。
- 读取 data.results.items；has_more 为 true 时继续请求 next_cursor。
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/company-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Example Sports"}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；has_more 为 true 时继续使用 next_cursor最佳使用场景
- 解析广告主 Page ID： 结合候选 Page ID、名称、URL、分类和国家，选择按 Page 发起 Company Ads 请求所需的标识。
- 比较同名与区域 Page： 对比名称相近广告主的分类、国家、实体类型、图片、验证值和关联 Instagram 上下文。
- 构建可复核广告主选择器： 在广告主选择器或研究索引中保存 Page 身份、可见受众信号、原始 query 和采集时间。
使用建议
- 只提交 query；Company Search 不接受 results_limit，也不接受广告国家、状态、媒体、语言、排序或日期筛选。
- 多个候选名称相近时，应对比 Page ID、URL、分类、国家、图片、验证值和关联 Instagram 身份，不要直接选择第一条结果。
- has_more 为 true 时继续使用 next_cursor，避免遗漏任务结果分页中的公司候选。
- 将 Instagram 身份、粉丝数、验证值、图片和 Page 删除状态视为可选信号，字段缺失时不要拒绝整条候选。
相关 API
需要其他类型的 Facebook Ad Library 公开数据时，可以使用以下 API。
- Facebook Ad Library Search API — 按关键词搜索公开广告，并支持匹配方式、广告类型、国家、状态、媒体、排序、日期和结果数量筛选。
- Facebook Ad Library Company Ads API — 通过一个广告主 Page ID 采集公开广告，返回创意、投放、市场、媒体、CTA 和可见指标字段。
- Facebook Ad Library Ad API — 通过广告 URL 采集一条公开 Ad Library 广告，返回创意、广告主、媒体、投放、CTA 和可见指标字段。