EU ad reach and audience breakdown — Meta ad library
meta-ad-library.meta-ads.library.eu_reachGet the EU reach, audience breakdown and payer of ads delivered in Europe
- Price
- freeプロバイダー原価
- Success rate
- —成功率データはまだありません成功率データはまだありません
- Latency p50
- ——
- Last verified
- —Not verified yet
GEThttps://toolswitch.dev/v1/tools/meta-ad-library.meta-ads.library.eu_reachPreview- Uses platform quota
- Synchronous response
- Reads public data
パラメータ
Meta publishes these under the EU Digital Services Act: eu_total_reach is an actual number of accounts reached (not a range), age_country_gender_reach_breakdown splits it by country/age/gender, beneficiary_payers names who paid and who benefits, and target_ages / target_gender / target_locations expose the advertiser's declared targeting — the only place any Meta ad targeting is public. All of it is missing for non-EU delivery, which reads as an empty response field rather than an error
| パラメータ | 型 | 必須 | 説明 | 例 |
|---|---|---|---|---|
| クエリパラメータ | ||||
limit | 整数 | 任意 | 25 | |
fields | 文字列 | 必須 | the DSA disclosure set | id,page_name,eu_total_reach,age_country_gender_reach_breakdown,beneficiary_payers,target_ages,target_gender,target_locations,ad_creative_bodies,ad_delivery_start_time |
search_terms | 文字列 | 任意 | electric car | |
search_page_ids | 配列 | 任意 | up to 10 Page ids, to scope to one advertiser | |
ad_active_status | 文字列 | 任意 | ALL | |
ad_reached_countries | 配列 | 必須 | EU/EEA member states only — the DSA fields are populated for EU delivery and are absent everywhere else | ["DE","FR"] |
- クエリパラメータ
limit整数任意例：
25fields文字列必須the DSA disclosure set
例：
id,page_name,eu_total_reach,age_country_gender_reach_breakdown,beneficiary_payers,target_ages,target_gender,target_locations,ad_creative_bodies,ad_delivery_start_timesearch_terms文字列任意例：
electric carsearch_page_ids配列任意up to 10 Page ids, to scope to one advertiser
ad_active_status文字列任意例：
ALLad_reached_countries配列必須EU/EEA member states only — the DSA fields are populated for EU delivery and are absent everywhere else
例：
["DE","FR"]
コード例
$TOOLSWITCH_KEY をコンソールで作成したキーに置き換えてください。
curl -X GET 'https://toolswitch.dev/v1/tools/meta-ad-library.meta-ads.library.eu_reach' \
-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.eu_reach",
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.eu_reach", {
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());このゲートウェイ API はプレビュー版です。URL や認証方式は変更される場合があります。 パラメータはサンプルデータです。 呼び出し料金は free です。サービス料を含みます。