Facebook Ads Library API无法返回网页端可见活跃广告的问题

问题场景 #

有个页面在Facebook广告库网页端明明能看到活跃广告，但调用Ads Library API却返回空结果。举个例子：

• 网页端可查到页面ID为2000786836855475的美国地区全状态广告
• 但调用以下API请求时无任何结果返回：

https://graph.facebook.com/v19.0/ads_archive?media_type=all&access_token=XXXXXXXXXXXXXXXXXXXXXXXXXXX&ad_reached_countries=US&ad_active_status=ACTIVE&limit=500&search_page_ids=2000786836855475

排查方向与解决办法 #

• 参数匹配差异：网页端筛选的是active_status=all，但API请求里用的是ad_active_status=ACTIVE。建议把API参数改为ad_active_status=ALL——网页端展示的是所有状态的广告（包括刚停投但仍在库中的），而ACTIVE仅返回当前正在投放的广告。
• 地区筛选逻辑不同：API的ad_reached_countries=US要求广告必须明确定向美国，而网页端的筛选可能包含“可能触达美国”的广告。可以尝试删除该参数，或者改用数组格式ad_reached_countries=["US"]（部分API版本要求此格式）。
• 权限与访问限制：确认你的access token拥有ads_archive权限，且未触发API调用频次限制。另外，部分广告因隐私或合规要求，仅允许在网页端公众展示，API无法获取这类广告。
• 页面ID与API版本问题：检查search_page_ids是否输入正确，同时确认v19.0版本的API是否兼容当前参数。可以尝试切换API版本，或者确认该页面的广告是否关联到其他商业账户，是否需要额外指定相关身份参数。
• 广告类型过滤遗漏：网页端设置的是ad_type=all，但API请求仅指定了media_type=all，未设置ad_type参数。建议添加ad_type=ALL参数，避免过滤掉特定类型的广告。

内容的提问来源于stack exchange，提问作者Fraz Khan