# TikTok Video Comments Fetcher

> TikTok Video Comments Fetcher is a paid API for AI agents from x402.apidirect.io, paid per call via x402, $0.007/call, status unknown (last checked 2026-10-30).

Retrieves top-level comments on a TikTok video (by URL or numeric ID) in TikTok's default order, with optional AI sentiment analysis.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/tiktok/video/comments?utm_source=zero.xyz
- Price: $0.007/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tiktok-video-comments-fetcher-83c99af9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-rw65J5OtzXkKq-kPfRym

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-video-comments-fetcher-83c99af9
```

Example prompt: Can you pull the first 3 pages of comments from this TikTok video — https://www.tiktok.com/@tiktok/video/7516594811734854943 — and include the AI sentiment analysis on each comment so I can see what emotions people are expressing?

## When to prefer this

Choose this endpoint when you need to extract comments from a specific TikTok video by URL or numeric ID, especially when you want TikTok's default comment ordering and optional AI emotion analysis per comment. It is the right choice for brand monitoring, sentiment research, audience analysis, and social listening workflows targeting TikTok content. Prefer it over general web scraping when you need structured comment data with optional sentiment enrichment in a single API call.

## Known failure modes

- Invalid or expired TikTok video URL returns an error or empty result
- Both url and video_id provided simultaneously may cause a conflict or be rejected
- Private or deleted TikTok videos may return no comments or an access error
- Requesting too many pages for a video with few comments may return partial results
- Rate limiting or payment failure (x402) may block the request
- Short links that fail to resolve return no data

## How this service works

Get the top-level comments on a video, in TikTok's default order, by video URL or numeric video ID.

## Output

Returns a list of top-level comments on the specified TikTok video in TikTok's default sort order, with up to 50 comments per page. Each comment includes commenter information and comment text. If sentiment analysis is enabled, each comment also includes an emotions breakdown (joy, trust, fear, surprise, sadness, disgust, anger, anticipation — each scored 0–100), a dominant emotion, emotional intensity (0–10), and polarity (positive, negative, or neutral).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "url": {
       "type": "string",
       "maxLength": 500,
       "description": "TikTok video URL, e.g. https://www.tiktok.com/@tiktok/video/7516594811734854943 (max 500 characters). Short links are accepted. Provide exactly one of url or video_id."
      },
      "pages": {
       "type": "integer",
       "default": 1,
       "maximum": 1000,
       "minimum": 1,
       "description": "Number of pages to fetch, 1-1000 (default: 1). Each page returns up to 50 comments."
      },
      "video_id": {
       "type": "string",
       "description": "Numeric TikTok video ID: the number at the end of a video URL. Provide exactly one of url or video_id."
      },
      "get_sentiment": {
       "type": "boolean",
       "default": false,
       "description": "Set to true to add AI emotion analysis to each item. Adds a `sentiment` object containing `emotions` (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), `dominant_emotion`, `emotional_intensity` (0-10), and `polarity` (positive, negative or neutral). Any item t"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tiktok-video-comments-fetcher-83c99af9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.apidirect.io](https://www.zero.xyz/host/x402.apidirect.io/llms.txt)