# agdata TikTok Data API

> agdata TikTok Data API is a paid API for AI agents from agdata.shveik.dev, paid per call via x402, $0.0315/call, status unknown (last checked 2026-10-14).

Fetch TikTok posts as structured JSON by profile, hashtag, or keyword search — paid per call with no account required.

## Facts

- Endpoint: POST https://agdata.shveik.dev/v1/x402/tiktok?utm_source=zero.xyz
- Price: $0.0315/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agdata-tiktok-data-api-905482d5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Qb2BtpLqfRNJz8RLlanOj

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 agdata-tiktok-data-api-905482d5 -d '<json body>'
```

Example prompt: Pull the last 10 TikTok posts from the profile 'charlidamelio' and give me their view counts, likes, and captions.

## When to prefer this

Choose this endpoint when you need structured TikTok post data (profiles, hashtags, or keyword search) without setting up a TikTok developer account or managing OAuth. It is ideal for agents that need on-demand social data paid per call in stablecoins, with no subscription or API key management. Prefer it over manual scraping or TikTok's official API when speed-to-integration and no-account access matter.

## Known failure modes

- TikTok account is private or suspended — returns empty results or error
- Query or username not found — returns empty array
- Rate limit or upstream block — returns 402 or 5xx error
- Invalid mode value — returns validation error
- Payment not received or insufficient funds — request rejected with 402

## How this service works

Unblock any URL as Markdown, or get search, social, maps, jobs and news as data. Paid per call in stablecoins over x402 or MPP, with no account.

## Output

A JSON array of TikTok post objects, each containing video ID, URL, caption text, author info, music metadata, hashtags, engagement counts (likes, plays, shares, comments, saves), creation timestamp, duration in seconds, and flags for ads and slideshows.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "raw": {
   "type": "boolean"
  },
  "mode": {
   "enum": [
    "profile",
    "hashtag",
    "search"
   ],
   "type": "string"
  },
  "limit": {
   "type": "integer",
   "maximum": 20,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "maxLength": 500
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "76650757…",
  "url": "https://…",
  "text": "Somethin…",
  "is_ad": false,
  "likes": 94300,
  "music": {},
  "plays": 1400000,
  "saves": 6979,
  "author": {},
  "shares": 3126,
  "comments": 2853,
  "hashtags": [],
  "created_at": "2026-07-…",
  "duration_s": 25,
  "is_slideshow": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agdata-tiktok-data-api-905482d5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agdata.shveik.dev](https://www.zero.xyz/host/agdata.shveik.dev/llms.txt)