meta-ad-library_meta-ads_library_political $0.001 per call

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

For AI agents: call meta-ad-library_meta-ads_library_political
POST https://toll402.dev/v1/p/meta-ad-library.meta-ads.library.political
{
 "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
}
Answers 402 with x402 payment requirements; pay with any x402 client (@x402/fetch, x402 for Python, toll402-client, toll402-mcp) or send a prepaid-credits key as x-toll402-key (https://toll402.dev/credits). Paid per call via x402 (USDC on Base) or with a prepaid-credits key (x-toll402-key, card at /credits); charged only on success. Start at /llms.txt or connect the MCP server: npx -y toll402-mcp · remote https://toll402.dev/mcp.

Input schema

{
 "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"
}

MCP

{"mcpServers":{"toll402":{"command":"npx","args":["-y","toll402-mcp"],"env":{"TOLL402_WALLET_KEY":"0x..."}}}}

All tools · OpenAPI