# StableSocial TikTok Ad Library Search

> StableSocial TikTok Ad Library Search is a paid API for AI agents from stablesocial.dev, paid per call via x402, $0.06/call, status unknown (last checked 2026-09-14).

Searches TikTok's Ad Library to retrieve ad creatives, advertiser info, and campaign data matching specified query parameters

## Facts

- Endpoint: POST https://stablesocial.dev/api/sc/tiktok/ad-library/search
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stablesocial-tiktok-ad-library-search-29ebd745
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VrVlGS56MYhJcB7TWdHzt

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stablesocial-tiktok-ad-library-search-29ebd745 -d '<json body>'
```

Example prompt: Search TikTok's Ad Library for ads related to 'fitness supplements' and show me what brands are advertising, their ad creatives, and any campaign details you can find.

## When to prefer this

Choose this endpoint when you need programmatic access to TikTok's Ad Library for competitive intelligence, ad creative research, or brand monitoring at scale. Prefer it over manual browsing of TikTok's Ad Library UI when you need structured data for downstream analysis or when automating competitor ad tracking workflows.

## Known failure modes

- No results returned if query keyword is too niche or has no active ads
- TikTok Ad Library may throttle or block scraping resulting in empty or partial results
- Region-specific ads may not appear if region filter is misspecified
- Stale data if TikTok's Ad Library hasn't refreshed recently
- Rate limiting or payment failure returning HTTP 402 if USDC balance is insufficient

## How this service works

Scrape Creators · TikTok — Ad Library Search

## Output

Returns a list of TikTok ad library entries matching the search query, including ad creatives (video/image thumbnails), advertiser names, ad IDs, impression date ranges, regions targeted, and any available performance or spend signals exposed by TikTok's public Ad Library.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "likes": {
   "enum": [
    "top_1_20",
    "top_21_40",
    "top_41_60",
    "top_61_80",
    "top_81_100"
   ],
   "type": "string",
   "description": "Likes percentile filter."
  },
  "limit": {
   "type": "number",
   "description": "Number of ads to return, max 50. Defaults to 20."
  },
  "query": {
   "type": "string",
   "description": "Optional keyword to search ad titles/content."
  },
  "cursor": {
   "type": "number",
   "description": "Page number to fetch. Use the cursor returned from the previous response, like 3 for page 3."
  },
  "period": {
   "enum": [
    "7",
    "30",
    "180"
   ],
   "type": "string",
   "description": "Time window for Top Ads."
  },
  "region": {
   "enum": [
    "DZ",
    "AR",
    "AU",
    "AT",
    "AZ",
    "BH",
    "BD",
    "BY",
    "BE",
    "BO",
    "BR",
    "BG",
    "KH",
    "CA",
    "CL",
    "CO",
    "CR",
    "HR",
    "CY",
    "CZ",
    "DK",
    "DO",
    "EC",
    "EG",
    "EE",
    "FI",
    "FR",
    "DE",
    "GR",
    "GT",
    "JO",
    "HU",
    "ID",
    "IQ",
    "IE",
    "IL",
    "IT",
    "JP",
    "KZ",
    "KE",
    "KW",
    "LV",
    "LB",
    "MY",
    "MX",
    "MA",
    "NL",
    "NZ",
    "NG",
    "NO",
    "OM",
    "PK",
    "PA",
    "PY",
    "PE",
    "PH",
    "PL",
    "PT",
    "PR",
    "QA",
    "LT",
    "RO",
    "SA",
    "RS",
    "SG",
    "SK",
    "SI",
    "ZA",
    "KR",
    "ES",
    "LK",
    "SE",
    "CH",
    "TW",
    "TH",
    "TR",
    "AE",
    "GB",
    "US",
    "UY",
    "VN"
   ],
   "type": "string",
   "description": "Country code. Defaults to US."
  },
  "duration": {
   "enum": [
    "under_10s",
    "10_20s",
    "20_30s",
    "30_40s",
    "40_50s",
    "over_50s"
   ],
   "type": "string",
   "description": "Video duration filter."
  },
  "industry": {
   "enum": [
    "apparel_accessories",
    "appliances",
    "apps",
    "baby_kids_maternity",
    "beauty_personal_care",
    "business_services",
    "ecommerce_non_app",
    "education",
    "financial_services",
    "food_beverage",
    "games",
    "health",
    "home_improvement",
    "household_products",
    "life_services",
    "news_entertainment",
    "pets",
    "sports_outdoor",
    "tech_electronics",
    "travel",
    "vehicle_transportation"
   ],
   "type": "string",
   "description": "Industry filter."
  },
  "order_by": {
   "enum": [
    "for_you",
    "impression",
    "play_2s_rate",
    "play_6s_rate",
    "cvr",
    
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablesocial-tiktok-ad-library-search-29ebd745/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablesocial.dev](https://www.zero.xyz/host/stablesocial.dev/llms.txt)