# TikTok Public Data Scraper (x402)

> TikTok Public Data Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Extracts structured metadata from public TikTok profiles, hashtag feeds, and individual video URLs on a pay-per-call basis.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/tiktok?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tiktok-public-data-scraper-x402-720d06f8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3IvwsaqfxQPDFwJnWKlzL

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 tiktok-public-data-scraper-x402-720d06f8 -d '<json body>'
```

Example prompt: Pull the latest 20 TikTok posts from the public profile @charlidamelio and also grab all videos tagged with #dancechallenge, up to 10 per hashtag, and give me the captions, post dates, and video URLs.

## When to prefer this

Choose this endpoint when you need structured TikTok video metadata (captions, timestamps, ad flags) from public profiles, hashtags, or specific video URLs without building your own scraper. It is pay-per-call with no charge for failed or empty runs, making it cost-efficient for sporadic or on-demand data needs. Prefer it over general web scrapers when the target is specifically TikTok public data.

## Known failure modes

- Profile or hashtag is private or removed — returns empty items array, no charge
- Invalid TikTok URL format — may return empty or error response
- TikTok public embed page exposes fewer videos than requested — returns whatever is available (typically 7–13 per profile/hashtag)
- Network or scraping failure — not charged
- maxItems set to 0 with no profiles/hashtags/postURLs provided — returns empty result

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count and an array of video items, each containing the video ID, caption text, creation timestamp (Unix and ISO), ad flag, slideshow flag, web video URL, and detected text language. Empty or failed runs are not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "hashtags": {
   "type": "array",
   "description": "Public hashtag names or TikTok tag URLs. Each available embed page supplies a short list of posts."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Hard limit across all profiles and video URLs. Set 0 for no limit."
  },
  "postURLs": {
   "type": "array",
   "description": "Public TikTok video URLs to extract individually."
  },
  "profiles": {
   "type": "array",
   "description": "TikTok usernames or public profile URLs. Each profile supplies the posts visible in its public embed page."
  },
  "resultsPerHashtag": {
   "type": "integer",
   "default": 10,
   "maximum": 30,
   "minimum": 1,
   "description": "Maximum videos to collect from each available public hashtag list. The page commonly exposes about 7 to 10 posts."
  },
  "resultsPerProfile": {
   "type": "integer",
   "default": 10,
   "maximum": 30,
   "minimum": 1,
   "description": "Maximum videos to collect from each profile. The public embed page commonly exposes about 10 to 13 posts."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "isAd": null,
    "text": null,
    "createTime": null,
    "isSlideshow": null,
    "webVideoUrl": null,
    "textLanguage": null,
    "createTimeISO": null
   }
  ],
  "product": "tiktok"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tiktok-public-data-scraper-x402-720d06f8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)