# TikTok Ad Library Search

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

Search TikTok Top Ads by keyword, filters, and metrics, or search the public Ads Library by advertiser name.

## Facts

- Endpoint: GET https://api.socialfetch.dev/v1/tiktok/ad-library/ads/search
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tiktok-ad-library-search-774dd19d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zgel_u4eomF8q-UTwTlMT

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 tiktok-ad-library-search-774dd19d
```

Example prompt: Search TikTok's Top Ads for beauty and personal care brands in the US over the last 30 days, sorted by impressions, and show me ads matching 'skincare routine'.

## When to prefer this

Use this endpoint when you need to discover and analyze TikTok ads — either top-performing ads filtered by industry, region, duration, format, and engagement metrics, or ads from a specific advertiser via the public Ads Library. Prefer this over general web search when you need structured, filterable TikTok ad data with performance signals.

## Known failure modes

- Invalid or unsupported region code returns an error
- Invalid enum value for orderBy, period, or adFormat returns a validation error
- Empty result set when no ads match the keyword or filters
- Expired or invalid pagination cursor causes a bad request error
- Rate limiting or quota exceeded returns a 429 error

## How this service works

Search TikTok Top Ads by keyword and filters, or search the public Ads Library by advertiser name.

## Output

Returns a list of TikTok ads matching the search criteria, including ad titles, content, performance metrics (impressions, CTR, CVR, likes), advertiser info, ad format, and a pagination cursor for fetching subsequent pages.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "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 for Top Ads."
      },
      "query": {
       "type": "string",
       "maxLength": 4096,
       "description": "Optional keyword to search ad titles and content."
      },
      "cursor": {
       "type": "string",
       "minLength": 1,
       "description": "Opaque pagination cursor from a previous response."
      },
      "period": {
       "enum": [
        "7",
        "30",
        "180"
       ],
       "type": "string",
       "description": "Time window in days 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 for Top Ads results. Defaults to US when omitted."
      },
      "orderBy": {
       "enum": [
      
… (truncated)
```

## More

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