# 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).

Fetches TikTok posts as structured JSON by searching a keyword/hashtag or browsing a profile, returning engagement metrics and metadata

## Facts

- Endpoint: POST https://agdata.shveik.dev/v1/mpp/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-19e335b9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1jn1fuZoQURXVk50l8ALP

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-19e335b9 -d '<json body>'
```

Example prompt: Search TikTok for the top 10 videos about 'sustainable fashion' and give me each one's likes, plays, and caption text.

## When to prefer this

Choose this endpoint when you need structured TikTok post data — engagement metrics, captions, author info — for keyword searches, hashtag feeds, or profile timelines without managing a TikTok API account or scraper. It is ideal for agents doing social listening, influencer research, or trend analysis and paying per call with no subscription required.

## Known failure modes

- Query returns no results if the hashtag or profile has no public posts
- Rate limits or TikTok-side blocks may cause empty or partial responses
- Invalid mode enum value returns a validation error
- Limit exceeding maximum of 20 is rejected
- Private or deleted profiles/videos return no data
- Stablecoin payment failure (insufficient balance) results in 402 response blocking the call

## 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 video objects, each containing the video ID, URL, caption text, is_ad flag, like/play/save/share/comment counts, author info, associated music, hashtags, creation timestamp, duration in seconds, and a slideshow flag.

## 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-19e335b9/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)