meta-ad-library_meta-ads_library_advertiser $0.001 per call

Ads a Facebook Page runs, by Page id — Meta ad library. List every ad a specific Facebook Page is currently running (Meta Ad Library · Meta Ads (Facebook & Instagram))

For AI agents: call meta-ad-library_meta-ads_library_advertiser
POST https://toll402.dev/v1/p/meta-ad-library.meta-ads.library.advertiser
{
 "search_page_ids": [
  "20531316728"
 ],
 "ad_reached_countries": [
  "US"
 ],
 "fields": "id,page_id,page_name,ad_creative_bodies,ad_creative_link_titles,ad_snapshot_url,ad_delivery_start_time,ad_delivery_stop_time,publisher_platforms,media_type",
 "ad_active_status": "ACTIVE",
 "limit": 50
}
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": {
  "search_page_ids": {
   "type": "array",
   "description": "JSON array of up to 10 numeric Facebook Page ids. You need the id, not the vanity handle — get it from a keyword search's page_id, or from the Page's About section",
   "examples": [
    [
     "20531316728"
    ]
   ]
  },
  "ad_reached_countries": {
   "type": "array",
   "examples": [
    [
     "US"
    ]
   ]
  },
  "fields": {
   "type": "string",
   "examples": [
    "id,page_id,page_name,ad_creative_bodies,ad_creative_link_titles,ad_snapshot_url,ad_delivery_start_time,ad_delivery_stop_time,publisher_platforms,media_type"
   ]
  },
  "ad_active_status": {
   "type": "string",
   "description": "ACTIVE (default) | INACTIVE | ALL",
   "examples": [
    "ACTIVE"
   ]
  },
  "ad_delivery_date_min": {
   "type": "string",
   "description": "YYYY-MM-DD"
  },
  "limit": {
   "type": "integer",
   "examples": [
    50
   ]
  },
  "after": {
   "type": "string"
  }
 },
 "additionalProperties": true,
 "required": [
  "search_page_ids",
  "ad_reached_countries",
  "fields"
 ],
 "description": "the competitor-monitoring shape: pin the advertiser, page through everything they run. One Page can run hundreds of near-identical creative variants, so count DISTINCT ad_creative_bodies rather than rows when sizing a competitor's output"
}

MCP

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

All tools · OpenAPI