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

Facebook ad library company ads by page id or name. Fetches all ads currently running for a specific company from the Meta Ad Library. (ScrapeCreators · Meta Ads (Facebook & Instagram))

For AI agents: call scrapecreators_x_v1-facebook-adlibrary-company-ads
POST https://toll402.dev/v1/p/scrapecreators.x.v1-facebook-adlibrary-company-ads
{
 "pageId": "367152833370567",
 "companyName": "Lululemon",
 "country": "ALL",
 "status": "ACTIVE",
 "media_type": "ALL",
 "language": "EN",
 "sort_by": "total_impressions",
 "start_date": "2025-01-01",
 "end_date": "2025-12-31",
 "cursor": "AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP",
 "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": {
  "pageId": {
   "type": "string",
   "description": "The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName",
   "examples": [
    "367152833370567"
   ]
  },
  "companyName": {
   "type": "string",
   "description": "The name of the company. Can either use this or pageId",
   "examples": [
    "Lululemon"
   ]
  },
  "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 refers to ads with image and text. Not sure why they call it meme.",
   "examples": [
    "ALL"
   ]
  },
  "language": {
   "type": "string",
   "description": "Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc",
   "examples": [
    "EN"
   ]
  },
  "sort_by": {
   "type": "string",
   "description": "Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions.",
   "examples": [
    "total_impressions"
   ]
  },
  "start_date": {
   "type": "string",
   "description": "Start date to search for. Format: YYYY-MM-DD",
   "examples": [
    "2025-01-01"
   ]
  },
  "end_date": {
   "type": "string",
   "description": "End date to search for. Format: YYYY-MM-DD",
   "examples": [
    "2025-12-31"
   ]
  },
  "cursor": {
   "type": "string",
   "description": "Cursor to paginate through results",
   "examples": [
    "AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP"
   ]
  },
  "trim": {
   "type": "boolean",
   "description": "Set to true for a trimmed down version of the response",
   "examples": [
    "false"
   ]
  }
 },
 "additionalProperties": true
}

MCP

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

All tools · OpenAPI