如何无需表单/广告组ID，通过Page ID获取Facebook主页全部线索

直接用Facebook主页ID调用leadgen_leads端点就能拉取该主页下所有线索，不需要单独指定表单或广告组ID，具体实现步骤如下：

核心API调用方式 #

使用Graph API的/{page-id}/leadgen_leads端点，这是官方明确支持的批量获取主页全量线索的方式。

请求示例（curl） #

curl -G \
  -d "access_token=<你的访问令牌>" \
  -d "time_range={\"since\":<起始时间戳>,\"until\":<结束时间戳>}" \
  -d "limit=100" \
  "https://graph.facebook.com/v18.0/<你的主页ID>/leadgen_leads"

关键参数说明 #

• access_token：必须拥有pages_show_list、leads_retrieval权限，且具备目标主页的访问权限（用户授权或系统用户关联主页）
• time_range：可选，用于过滤指定时间段内的线索，默认返回最近30天数据；若需拉取更早数据，必须指定since时间戳
• limit：可选，控制单次返回的线索数量，默认25，最大1000
• 分页：返回结果包含paging.next字段，可通过该URL继续请求后续页数据，直到无更多结果

官方文档核心内容翻译 #

Facebook营销API线索获取指南：
检索线索支持三种查询维度：

1. 按表单ID：/{form-id}/leads —— 获取单个表单的线索
2. 按广告组ID：/{adgroup-id}/leads —— 获取单个广告组的线索
3. 按主页ID：/{page-id}/leadgen_leads —— 获取该主页关联的所有表单、所有广告组产生的全部线索，无需指定form_id或ad_group_id。
   调用前需确保持有对应权限与有效访问令牌。

注意事项 #

• 权限校验：如果返回权限错误，检查访问令牌是否包含主页权限和线索检索权限，且令牌未过期
• 数据完整性：如果线索量较大，务必处理分页逻辑，避免遗漏数据
• 时间范围限制：未指定time_range时仅返回最近30天线索，如需历史数据必须明确设置since参数

内容的提问来源于stack exchange，提问作者Ahmed Monem