# StableSocial TikTok Search

> StableSocial TikTok Search is a paid API for AI agents from socialx402.com, paid per call via x402, $0.06/call, status unknown (last checked 2026-09-13).

Search TikTok for videos, users, or hashtags by keyword via a pay-per-request POST endpoint with no subscription required.

## Facts

- Endpoint: POST https://socialx402.com/api/tiktok/search
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stablesocial-tiktok-search-94b24377
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_A2a4aZL1ny4GyiEPdvLpQ

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-search-94b24377 -d '<json body>'
```

Example prompt: Search TikTok for the top results on the keyword 'sourdough bread' and show me the video titles, view counts, and creator handles.

## When to prefer this

Choose this endpoint when you need TikTok search results without managing API credentials or subscriptions, and you want pay-per-use pricing. Ideal for agents doing one-off research, brand monitoring, or content discovery on TikTok where setting up an official TikTok developer account is impractical.

## Known failure modes

- Payment not included or insufficient USDC — returns 402 Payment Required
- Invalid or missing query parameter — returns 400 Bad Request
- TikTok rate limiting or platform changes cause empty or degraded results
- Keyword returns no results — empty result set returned
- Network timeout or upstream TikTok API failure — 503 or 500 error

## How this service works

Pay-per-request access to social media data from TikTok, Instagram, Facebook, Reddit, and LinkedIn. No auth, no subscriptions.

## Output

A list of TikTok search results matching the query, likely including video metadata such as titles, view counts, like counts, creator usernames, and URLs.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cursor": {
   "type": "string",
   "description": "Pagination cursor"
  },
  "keywords": {
   "type": "string",
   "minLength": 1,
   "description": "Search keywords"
  },
  "max_posts": {
   "type": "integer",
   "default": 50,
   "maximum": 9007199254740991,
   "minimum": -9007199254740991,
   "description": "Maximum posts to collect"
  },
  "sort_type": {
   "enum": [
    "relevance",
    "like_count",
    "date_posted"
   ],
   "type": "string",
   "description": "Sort type"
  },
  "date_posted": {
   "enum": [
    "all",
    "past_day",
    "past_week",
    "past_month",
    "past_half_year"
   ],
   "type": "string",
   "description": "Date filter"
  },
  "max_page_size": {
   "type": "integer",
   "default": 50,
   "maximum": 9007199254740991,
   "minimum": -9007199254740991,
   "description": "Results per page"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablesocial-tiktok-search-94b24377/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from socialx402.com](https://www.zero.xyz/host/socialx402.com/llms.txt)
