# StableSocial TikTok User Posts

> StableSocial TikTok User Posts 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-12).

Fetches a TikTok user's posts/videos by username, with pagination and sorting options

## Facts

- Endpoint: POST https://stablesocial.dev/api/tiktok/posts?utm_source=zero.xyz
- Price: $0.06/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-10-12
- 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-posts-266864b8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3XiwM6H-1zWuka9_3zZjN

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-posts-266864b8 -d '<json body>'
```

Example prompt: Pull the 100 most recent posts from TikTok user @charlidamelio, sorted by newest first.

## When to prefer this

Use this endpoint when you need to programmatically retrieve a TikTok user's post history with control over sort order and pagination. Prefer this over manual scraping when you need structured video metadata at scale, or when building analytics pipelines around specific TikTok creators.

## Known failure modes

- Invalid or non-existent TikTok handle returns an error
- Rate limiting or TikTok blocking may result in partial results
- Private or restricted accounts may return empty or limited data
- Invalid cursor causes pagination failure
- Exceeding max_posts limit returns validation 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 paginated list of TikTok posts/videos for the specified user, including video metadata such as post IDs, dates, and content details. Also returns a pagination cursor for fetching additional pages.

## Example request

```json
{
 "handle": "tiktok",
 "order_by": "date_desc",
 "max_posts": 10,
 "max_page_size": 10
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cursor": {
   "type": "string",
   "description": "Pagination cursor"
  },
  "handle": {
   "type": "string",
   "minLength": 1,
   "description": "TikTok username"
  },
  "order_by": {
   "enum": [
    "date_desc",
    "date_asc",
    "id_desc"
   ],
   "type": "string",
   "description": "Sort order"
  },
  "max_posts": {
   "type": "integer",
   "default": 50,
   "maximum": 300,
   "minimum": -9007199254740991,
   "description": "Maximum number of posts to collect"
  },
  "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-posts-266864b8/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)