anyapi_facebook_ads_search $0.0025 per call

Facebook Ad Search. Search the Meta Ad Library by keyword and get matching ads (advertiser, creative text, CTA, platforms, and run dates) with cursor pagination. (AnyAPI · Facebook)

For AI agents: call anyapi_facebook_ads_search
POST https://toll402.dev/v1/p/anyapi.facebook.ads_search
{
 "country": "US",
 "query": "nike",
 "searchType": "keyword_exact_phrase"
}
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": {
  "adType": {
   "type": "string",
   "description": "Restrict to all ads (default) or only political and issue ads.",
   "enum": [
    "all",
    "political_and_issue_ads"
   ]
  },
  "country": {
   "type": "string",
   "description": "Two-letter country code to scope results. Omit for all countries.",
   "examples": [
    "US"
   ]
  },
  "cursor": {
   "type": "string",
   "description": "Opaque pagination cursor from a previous response's nextCursor."
  },
  "endDate": {
   "type": "string",
   "description": "Filter to ads with impressions on or before this date, in YYYY-MM-DD format."
  },
  "mediaType": {
   "type": "string",
   "description": "Creative media type filter.",
   "enum": [
    "ALL",
    "IMAGE",
    "VIDEO",
    "MEME",
    "IMAGE_AND_MEME",
    "NONE"
   ]
  },
  "query": {
   "type": "string",
   "description": "Keyword to search the Meta Ad Library for (e.g. \"protein powder\").",
   "examples": [
    "nike"
   ]
  },
  "searchType": {
   "type": "string",
   "description": "Match mode for the query: loose keyword match (keyword_unordered, the default) or exact phrase (keyword_exact_phrase).",
   "enum": [
    "keyword_unordered",
    "keyword_exact_phrase"
   ],
   "examples": [
    "keyword_exact_phrase"
   ]
  },
  "sortBy": {
   "type": "string",
   "description": "Sort order: impressions (highest first, the default) or recent (most recent).",
   "enum": [
    "impressions",
    "recent"
   ]
  },
  "startDate": {
   "type": "string",
   "description": "Filter to ads with impressions on or after this date, in YYYY-MM-DD format."
  },
  "status": {
   "type": "string",
   "description": "Ad status filter.",
   "default": "ACTIVE",
   "enum": [
    "ALL",
    "ACTIVE",
    "INACTIVE"
   ]
  }
 },
 "additionalProperties": true,
 "required": [
  "query"
 ]
}

MCP

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

All tools · OpenAPI