# API Direct – TikTok Hashtag Videos

> API Direct – TikTok Hashtag Videos 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).

Fetches videos posted under a TikTok hashtag, identified by name, numeric ID, or URL, with optional AI sentiment/emotion analysis per video.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/tiktok/hashtag/videos?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/api-direct-tiktok-hashtag-videos-88ad11fc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oREIn-brgitra86LXXX4V

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 api-direct-tiktok-hashtag-videos-88ad11fc
```

Example prompt: Pull the first 3 pages of TikTok videos under the hashtag #cooking and include AI sentiment analysis for each video so I can see the dominant emotions.

## When to prefer this

Use this endpoint when you need to retrieve actual video content (not just hashtag metadata) from TikTok for a known hashtag, especially when you want paginated results or AI-powered emotional sentiment scoring per video. Prefer this over a hashtag search endpoint when you already know the hashtag identifier. Choose it when you need bulk video data (up to 1000 pages × 20 videos) rather than a single hashtag's stats.

## Known failure modes

- Invalid or non-existent hashtag name returns empty results or 404
- Providing more than one of name/hashtag_id/url simultaneously causes a validation error
- Pages value outside 1-1000 range triggers a parameter validation error
- Private or restricted hashtags may return no videos
- Rate limiting or payment failure results in 402 or 429 error

## How this service works

Get the videos under a hashtag by name, numeric hashtag ID, or hashtag URL.

## Output

Returns a paginated list of TikTok videos under the specified hashtag (up to 20 per page), including video metadata such as title, author, view counts, and engagement. When sentiment analysis is enabled, each video also includes an emotions object (joy, trust, fear, surprise, sadness, disgust, anger, anticipation scored 0-100), 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 hashtag URL, e.g. https://www.tiktok.com/tag/cooking (max 500 characters). Provide exactly one of name, hashtag_id, or url."
      },
      "name": {
       "type": "string",
       "maxLength": 100,
       "description": "Hashtag name, with or without leading # (max 100 characters). Provide exactly one of name, hashtag_id, or url."
      },
      "pages": {
       "type": "integer",
       "default": 1,
       "maximum": 1000,
       "minimum": 1,
       "description": "Number of pages to fetch, 1-1000 (default: 1). Each page returns up to 20 videos."
      },
      "hashtag_id": {
       "type": "string",
       "description": "Numeric hashtag ID, as returned by Search Hashtags. Provide exactly one of name, hashtag_id, or url."
      },
      "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/api-direct-tiktok-hashtag-videos-88ad11fc/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)