Political and issue ads with spend — Meta ad library
meta-ad-library.meta-ads.library.politicalSearch political and issue ads and see who paid for them and roughly how much
- 价格
- free按供应商原价
- 成功率
- —暂无成功率数据暂无成功率数据
- 延迟 p50
- ——
- 最后验证
- —尚未验证
GEThttps://toolswitch.dev/v1/tools/meta-ad-library.meta-ads.library.political预览- 可用平台额度调用
- 同步返回
- 读取公开数据
参数
spend and impressions are RANGES — {"lower_bound":"100","upper_bound":"499"} — never point values, so totals across ads can only be reported as a range. demographic_distribution and delivery_by_region come back as percentage breakdowns that sum to ~1. Political ads stay in the library for seven years, unlike commercial ones
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| 查询参数 | ||||
limit | 整数 | 可选 | 25 | |
fields | 字符串 | 必填 | the disclosure fields only exist on this ad_type | id,page_name,bylines,currency,spend,impressions,demographic_distribution,delivery_by_region,ad_creative_bodies,ad_delivery_start_time,ad_delivery_stop_time |
ad_type | 字符串 | 必填 | POLITICAL_AND_ISSUE_ADS — this is what unlocks the spend/impressions/demographic fields | POLITICAL_AND_ISSUE_ADS |
bylines | 数组 | 可选 | JSON array of exact paid-for-by disclaimers; POLITICAL_AND_ISSUE_ADS only | |
search_terms | 字符串 | 可选 | climate | |
delivery_by_region | 数组 | 可选 | state / province names; POLITICAL_AND_ISSUE_ADS only | ["California"] |
ad_delivery_date_min | 字符串 | 可选 | YYYY-MM-DD | |
ad_reached_countries | 数组 | 必填 | ["US"] | |
- 查询参数
limit整数可选示例：
25fields字符串必填the disclosure fields only exist on this ad_type
示例：
id,page_name,bylines,currency,spend,impressions,demographic_distribution,delivery_by_region,ad_creative_bodies,ad_delivery_start_time,ad_delivery_stop_timead_type字符串必填POLITICAL_AND_ISSUE_ADS — this is what unlocks the spend/impressions/demographic fields
示例：
POLITICAL_AND_ISSUE_ADSbylines数组可选JSON array of exact paid-for-by disclaimers; POLITICAL_AND_ISSUE_ADS only
search_terms字符串可选示例：
climatedelivery_by_region数组可选state / province names; POLITICAL_AND_ISSUE_ADS only
示例：
["California"]ad_delivery_date_min字符串可选YYYY-MM-DD
ad_reached_countries数组必填示例：
["US"]
代码示例
将 $TOOLSWITCH_KEY 替换为你在控制台创建的密钥。
curl -X GET 'https://toolswitch.dev/v1/tools/meta-ad-library.meta-ads.library.political' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/meta-ad-library.meta-ads.library.political",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/meta-ad-library.meta-ads.library.political", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());网关接口为预览版，地址与鉴权方式可能调整。 示例参数仅为样例数据。 调用按 free 计费，已含服务费。