apify_tiktok-ads_library_search $0.00375 per call

Scrape the TikTok ad library by keyword. Scrape publicly running TikTok ads from TikTok's ad library by keyword or advertiser (Apify · TikTok Ads)

For AI agents: call apify_tiktok-ads_library_search
POST https://toll402.dev/v1/p/apify.tiktok-ads.library.search
{
 "search": "nike",
 "region": "all",
 "query_type": "1",
 "limit": 1,
 "offset": 0
}
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": {
   "type": "string",
   "description": "keyword or advertiser name to search the ad library for",
   "examples": [
    "skincare"
   ]
  },
  "adv_biz_ids": {
   "type": "string",
   "description": "advertiser business id, to pin the search to one advertiser instead of a keyword"
  },
  "ad_id": {
   "type": "string",
   "description": "fetch one specific ad"
  },
  "region": {
   "type": "string",
   "description": "ISO country code or 'all' (the default). TikTok's library is a DSA transparency database, so coverage is EU/EEA/UK-centric — and per the actor's own input schema it REJECTS region=US; pass 'all' to include US ads",
   "examples": [
    "all"
   ]
  },
  "query_type": {
   "type": "string",
   "description": "which field `search` is matched against: '1' = advertiser name (the actor's DEFAULT), '0' = keyword. A keyword passed without query_type:'0' is matched as an advertiser name and finds nothing",
   "examples": [
    "1"
   ]
  },
  "start_date": {
   "type": "string",
   "description": "YYYY-MM-DD",
   "examples": [
    "2026-06-01"
   ]
  },
  "end_date": {
   "type": "string",
   "description": "YYYY-MM-DD"
  },
  "sort": {
   "type": "string"
  },
  "limit": {
   "type": "integer",
   "description": "results to return; pair it with maxTotalChargeUsd",
   "examples": [
    50
   ]
  },
  "offset": {
   "type": "integer",
   "examples": [
    0
   ]
  }
 },
 "additionalProperties": true,
 "required": [
  "search"
 ],
 "description": "returns creative content, advertiser, dates, audience reach and targeting as TikTok discloses them in the Commercial Content Library. Community actor, not an official TikTok surface — the only route to this capability in the catalog, and the one most likely to break upstream, so check the actor's run history before relying on it"
}

MCP

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

All tools · OpenAPI