scrapecreators_x_v1-facebook-adlibrary-search-ads $0.00235 per call

Search Facebook ad library ads by keyword. Searches the Meta Ad Library by keyword and returns matching ads. (ScrapeCreators · Meta Ads (Facebook & Instagram))

For AI agents: call scrapecreators_x_v1-facebook-adlibrary-search-ads
POST https://toll402.dev/v1/p/scrapecreators.x.v1-facebook-adlibrary-search-ads
{
 "query": "running",
 "sort_by": "total_impressions",
 "search_type": "keyword_unordered",
 "ad_type": "all",
 "country": "ALL",
 "status": "ACTIVE",
 "media_type": "ALL",
 "start_date": "2025-01-05",
 "end_date": "2025-02-16",
 "cursor": "AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-",
 "trim": "false"
}
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": {
  "query": {
   "type": "string",
   "description": "Keyword to search for",
   "examples": [
    "running"
   ]
  },
  "sort_by": {
   "type": "string",
   "description": "Order only. One of: total_impressions | relevancy_monthly_grouped. Defaults to impressions ranking (total_impressions). Controls result ORDER, not verified performance — does not guarantee non-null spend, impressions_text, or a positive imp",
   "enum": [
    "total_impressions",
    "relevancy_monthly_grouped"
   ],
   "examples": [
    "total_impressions"
   ]
  },
  "search_type": {
   "type": "string",
   "description": "If you want to search by exact phrase or not",
   "examples": [
    "keyword_unordered"
   ]
  },
  "ad_type": {
   "type": "string",
   "description": "Search for all ads or only political and issue ads",
   "examples": [
    "all"
   ]
  },
  "country": {
   "type": "string",
   "description": "This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.",
   "examples": [
    "ALL"
   ]
  },
  "status": {
   "type": "string",
   "description": "Status of the ad. Defaults to ACTIVE.",
   "examples": [
    "ACTIVE"
   ]
  },
  "media_type": {
   "type": "string",
   "description": "Media type of the ad. Defaults to ALL. Meme just means the ad has text and an image. No clue why they call it meme.",
   "examples": [
    "ALL"
   ]
  },
  "start_date": {
   "type": "string",
   "description": "Impressions start date. Needs to be in YYYY-MM-DD format.",
   "examples": [
    "2025-01-05"
   ]
  },
  "end_date": {
   "type": "string",
   "description": "Impressions end date. Needs to be in YYYY-MM-DD format.",
   "examples": [
    "2025-02-16"
   ]
  },
  "cursor": {
   "type": "string",
   "description": "Cursor to paginate through results",
   "examples": [
    "AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-"
   ]
  },
  "trim": {
   "type": "boolean",
   "description": "Set to true for a trimmed down version of the response",
   "examples": [
    "false"
   ]
  }
 },
 "additionalProperties": true,
 "required": [
  "query"
 ],
 "description": "sort_by is order-only: ranking by total_impressions does not mean the response carries verified spend or impression counts. Search may return a non-null collation_count that is null on scrapecreators.x.v1-facebook-adlibrary-ad detail for the same ad — grouping semantics differ between search and detail; do not treat collation_count as creative-variant or budget counts."
}

MCP

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

All tools · OpenAPI