{"stats":{"calls7d":0,"successRate":null,"avgMs":null,"reviews":0,"usefulRate":null},"id":"p/meta-ad-library.meta-ads.library.political","kind":"provider","name":"meta-ad-library_meta-ads_library_political","description":"Political and issue ads with spend — Meta ad library. Search political and issue ads and see who paid for them and roughly how much (Meta Ad Library · Meta Ads (Facebook & Instagram))","tags":["meta-ads","advertising","meta-ad-library","library","political","data"],"method":"POST","path":"/v1/p/meta-ad-library.meta-ads.library.political","url":"https://toll402.dev/v1/p/meta-ad-library.meta-ads.library.political","specUrl":"https://toll402.dev/v1/spec/p/meta-ad-library.meta-ads.library.political","price":"$0.001","priceUsd":0.001,"available":true,"inputSchema":{"type":"object","properties":{"ad_type":{"type":"string","description":"POLITICAL_AND_ISSUE_ADS — this is what unlocks the spend/impressions/demographic fields","examples":["POLITICAL_AND_ISSUE_ADS"]},"ad_reached_countries":{"type":"array","examples":[["US"]]},"fields":{"type":"string","description":"the disclosure fields only exist on this ad_type","examples":["id,page_name,bylines,currency,spend,impressions,demographic_distribution,delivery_by_region,ad_creative_bodies,ad_delivery_start_time,ad_delivery_stop_time"]},"search_terms":{"type":"string","examples":["climate"]},"bylines":{"type":"array","description":"JSON array of exact paid-for-by disclaimers; POLITICAL_AND_ISSUE_ADS only"},"delivery_by_region":{"type":"array","description":"state / province names; POLITICAL_AND_ISSUE_ADS only","examples":[["California"]]},"ad_delivery_date_min":{"type":"string","description":"YYYY-MM-DD"},"limit":{"type":"integer","examples":[25]}},"additionalProperties":true,"required":["ad_type","ad_reached_countries","fields"],"description":"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"},"example":{"ad_type":"POLITICAL_AND_ISSUE_ADS","ad_reached_countries":["US"],"fields":"id,page_name,bylines,currency,spend,impressions,demographic_distribution,delivery_by_region,ad_creative_bodies,ad_delivery_start_time,ad_delivery_stop_time","search_terms":"climate","delivery_by_region":["California"],"limit":25},"meta":{"provider":"Meta Ad Library","providerSlug":"meta-ad-library","providerDocs":"https://www.facebook.com/ads/library/api/","providerPricing":"https://www.facebook.com/ads/library/api","providerLogo":"https://www.google.com/s2/favicons?domain=www.facebook.com&sz=64","platform":"meta-ads","platformLabel":"Meta Ads (Facebook & Instagram)","category":"Advertising","capability":"meta-ads.library.political","upstreamMethod":"GET","upstreamPriceUsd":0,"pricing":"free","pricingNote":"no per-call charge; Graph API app-level rate limits apply","verified":null,"docs":"https://www.facebook.com/ads/library/api/","calls":0,"successRate":null,"via":"treg"}}