Facebook Ad Library Company Search API

Facebook Ad Library Company Search

主要特性

• 按公司与 Page 名称搜索提交一个非空公司、品牌或 Page 名称 query，获取该次查询返回的全部广告主 Page 候选。
• Page 身份与分类在公开记录提供时返回 Page ID、名称、派生公开 URL、分类、国家、实体类型、验证值、图片和 Page 删除状态。
• 可见 Page 与 Instagram 信号在标准化候选中保留可用 Facebook 点赞数，以及关联 Instagram username、粉丝数和验证状态。

参数

如何使用

提交一个公司或 Page 名称 query，跟踪异步任务，并检查标准化广告主 Page 候选。

1. 准备一个非空公司、品牌或公开 Page 名称 query。
2. 将 query POST 到 /v1/facebook-ad-library/company-search，并保存返回的 task_id。
3. 轮询 /v1/tasks/{task_id}，直到任务成功或失败。
4. 读取 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