# SocialFetch TikTok Video Search

> SocialFetch TikTok Video 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 videos by keyword with optional filters for region, sort order, and date posted.

## Facts

- Endpoint: GET https://api.socialfetch.dev/v1/tiktok/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/socialfetch-tiktok-video-search-cbdae74b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RhHSoJVgC03DK5p7zPYm5

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 socialfetch-tiktok-video-search-cbdae74b
```

Example prompt: Search TikTok for videos about 'sustainable fashion' in the US, sorted by most-liked, posted within the last 3 months.

## When to prefer this

Use this endpoint when you need to search TikTok videos by keyword with support for region filtering, date range filtering, and sort ordering. Prefer this over general web search when you specifically need TikTok video results with structured metadata and pagination support.

## Known failure modes

- Missing required 'query' parameter returns a 400 error
- Invalid region code returns no localized results or an error
- Expired or invalid pagination cursor returns an error or empty results
- Query too long (over 512 characters) is rejected
- Rate limiting or quota exceeded returns a 429 or payment-related error
- TikTok platform unavailability may cause upstream errors

## How this service works

Search TikTok videos by free-text keyword (not hashtag — use tiktok.search.hashtag.list for that).

## Output

A list of TikTok video results matching the search query, including video metadata such as titles, authors, view counts, and links, plus an opaque pagination cursor for fetching the next page of results. When trim is true, a reduced set of fields is returned.

## 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",
     "required": [
      "query"
     ],
     "properties": {
      "trim": {
       "type": "boolean",
       "description": "When true, returns a smaller response with fewer fields."
      },
      "query": {
       "type": "string",
       "maxLength": 512,
       "minLength": 1,
       "description": "Search query text for TikTok videos."
      },
      "cursor": {
       "type": "string",
       "minLength": 1,
       "description": "Opaque pagination cursor returned by a previous response."
      },
      "region": {
       "type": "string",
       "description": "Optional two-letter ISO 3166-1 country code for localized search results."
      },
      "sortBy": {
       "enum": [
        "relevance",
        "most-liked",
        "date-posted"
       ],
       "type": "string",
       "description": "Optional sort order for search results."
      },
      "datePosted": {
       "enum": [
        "yesterday",
        "this-week",
        "this-month",
        "last-3-months",
        "last-6-months",
        "all-time"
       ],
       "type": "string",
       "description": "Optional upload date filter for video results."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/socialfetch-tiktok-video-search-cbdae74b/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)