Meta Ad Library API无法返回特定页面广告的技术求助

对接Facebook Ad Library API时，部分页面无法返回全部广告甚至无结果。例如Hunger Games页面在官网广告库显示20余条广告，但调用API返回{"data":[]}。调用代码如下：

const axios = require('axios');

let config = {
  method: 'get',
  url: 'https://graph.facebook.com/v18.0/ads_archive?ad_type=ALL&ad_reached_countries=["AD","AE","AG","AI","AL","AM","AO","AQ","AR","AT","AU","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BM","BN","BO","BR","BS","BT","BV","BW","BY","BZ","CA","CD","CF","CG","CH","CI","CL","CM","CO","CR","CV","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","ER","ES","ET","FI","FJ","FK","FM","FR","GA","GB","GD","GE","GG","GH","GI","GM","GN","GQ","GR","GS","GT","GW","GY","HN","HR","HT","HU","ID","IE","IL","IM","IN","IO","IQ","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MG","MH","MK","ML","MM","MN","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NE","NG","NI","NL","NO","NP","NR","NZ","OM","PA","PE","PG","PH","PK","PL","PN","PS","PT","PW","PY","QA","RO","RS","RW","SA","SB","SC","SE","SG","SH","SI","SK","SL","SM","SN","SO","SR","SS","ST","SV","SZ","TC","TD","TG","TH","TJ","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","US","UY","UZ","VA","VC","VE","VG","VN","VU","WS","XK","YE","ZA","ZM","ZW"]&access_token=ACCESS_TOKEN&ad_active_status=ALL&media_type=ALL&search_page_ids=159746560708670'
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

另外发现传递ad_reached_countries=ALL时无广告返回，必须传入所有国家的数组，但即使这样仍无法获取目标页面的广告，尝试过FB Graph Explorer、Radlibrary及Ad Library API脚本仓库，均未得到预期结果。

1. 验证权限与访问令牌 #

• 确认你的access_token已获得ads_archive的访问权限，且令牌未过期。可在Facebook开发者后台的令牌调试工具中检查权限范围。
• 部分广告（如政治、选举类）需要额外申请权限才能通过API获取，即使官网可见，API访问也需对应权限。

2. 优化请求参数 #

• 缩小国家范围：不要传递全量国家数组，先从官网广告的目标国家入手，只传这些国家代码（比如先尝试["US"]）。全量数组可能触发API的过滤逻辑，导致有效结果被屏蔽。
• 添加分页参数：API默认返回结果数量有限，需通过分页获取完整数据。请求中添加limit=100（API允许的最大值），并检查返回结果的paging字段，使用after游标请求下一页数据。
• 核对参数一致性：确保API参数与官网筛选条件完全匹配，比如ad_active_status=ALL对应官网的active_status=all，ad_type=ALL对应ad_type=all，注意参数值的大小写和格式。

3. 考虑数据同步延迟与规则限制 #

• 官网广告库与API存在数据同步延迟，官网显示的广告可能还未同步到API，等待1-2天后重试。
• 部分广告因隐私政策或API限制，不会通过接口返回，即使官网可见，这种情况属于平台规则，无法绕过。

4. 开启调试日志排查问题 #

• 在请求URL中添加debug=all参数，获取详细的API返回日志，查看是否有隐藏的错误提示或过滤原因。
• 捕获并打印完整的错误响应（包括状态码、响应头），空数组返回往往伴随权限不足或参数不符合要求的隐藏错误信息。

内容的提问来源于stack exchange，提问作者Erfan Poursina