Political and issue ads with spend — Meta ad library

meta-ad-library.meta-ads.library.political

Search political and issue ads and see who paid for them and roughly how much

Price: free제공업체 원가
Success rate: —성공률 데이터가 아직 없습니다성공률 데이터가 아직 없습니다
Latency p50: ——
Last verified: —Not verified yet

GEThttps://toolswitch.dev/v1/tools/meta-ad-library.meta-ads.library.politicalPreview

Uses platform quota
Synchronous response
Reads public data

파라미터

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정수선택
예시: 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"]

코드 예제

$TOOLSWITCH_KEY를 콘솔에서 생성한 키로 바꾸세요.

Preview

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());

게이트웨이 API는 미리보기 버전이며 URL과 인증 방식이 변경될 수 있습니다. 예제 매개변수는 샘플 데이터입니다. 호출 요금은 free이며 서비스 수수료가 포함되어 있습니다.