# StableSocial TikTok Search

> StableSocial TikTok Search is a paid API for AI agents from StableSocial at stablesocial.dev, paid per call via MPP or x402, $0.06/call, status unknown (last checked 2026-10-11).

Search TikTok posts by keyword with sorting and date filtering options

## Facts

- Endpoint: POST https://stablesocial.dev/api/tiktok/search?utm_source=zero.xyz
- Price: $0.06/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: StableSocial
- Docs: https://stablesocial.dev
- Website: https://stablesocial.dev
- Tags: tiktok, instagram, facebook, reddit, scraping, social, data, x402
- Canonical page: https://www.zero.xyz/c/stablesocial-search-a014d0ae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E6vijc4Ggmr-D2gmJmMJe

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

Example prompt: Search TikTok for posts about 'sustainable fashion', sorted by like_count, from the past_month, and get up to 100 posts.

## When to prefer this

Use this endpoint when you need to search TikTok posts by keyword with control over sort order (relevance, likes, or recency) and date range. Prefer this over Instagram or Reddit search endpoints when the target platform is TikTok. Ideal for brand monitoring, trend research, competitor analysis, or collecting training data from TikTok.

## Known failure modes

- Invalid or missing keywords field returns a 400 validation error
- TikTok rate limiting or anti-scraping measures may result in partial or empty results
- Invalid sort_type or date_posted enum value returns a validation error
- Expired or invalid pagination cursor may return unexpected results
- Network timeout on large max_posts requests

## 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 posts matching the search keywords, including post metadata such as video details, engagement metrics, and author info, along with a pagination cursor for fetching additional results.

## Example request

```json
{
 "keywords": "artificial intelligence",
 "max_posts": 10,
 "sort_type": "relevance",
 "date_posted": "past_month"
}
```

## 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"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "jobId": "clx0000000000000000000000",
  "token": "eyJ...",
  "status": "pending",
  "pollUrl": "https://stablesocial.dev/api/jobs/clx0000000000000000000000"
 }
}
```

## More

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