All endpoints
TikTok Hashtag Videos

TikTok Hashtag Videos API

Get the videos under a hashtag by name, numeric hashtag ID, or hashtag URL. Returns the same fields as User Videos for each video, about 20 per page.

Price: $0.006 per page
Free tier: 50 requests/month
Get API Key Documentation
Endpoint
GET /v1/tiktok/hashtag/videos

Parameters

name
Hashtag name, with or without leading # (max 100 characters). Provide exactly one of name, hashtag_id, or url.
hashtag_id
Numeric hashtag ID, as returned by Search Hashtags. Provide exactly one of name, hashtag_id, or url.
url
TikTok hashtag URL, e.g. https://www.tiktok.com/tag/cooking (max 500 characters). Provide exactly one of name, hashtag_id, or url.
pages
Number of pages to fetch, 1-1000 (default: 1). Each page returns up to 20 videos.
get_sentiment
Set to true to add AI emotion analysis (+$0.001/page)

Response fields

videos
Array of videos under the hashtag
video_id
Numeric video ID
title
Video caption
url
Direct link to the video
date
Publication date and time
date_timestamp
Publication date as a Unix timestamp
author
Author's TikTok username
source
"TikTok"
domain
"tiktok.com"
snippet
Video caption text
region
2-letter region code the video was posted from
play_count
Number of plays/views
likes
Number of likes
comments
Number of comments
shares
Number of shares
downloads
Number of downloads
saves
Number of saves (favorites)
duration
Video duration in seconds (0 for photo posts)
is_ad
Whether the video is an ad
is_pinned
Whether the video is pinned to the author's profile
author_name
Author's display name
author_id
Author's numeric user ID
author_avatar
Author's avatar URL
author_url
Link to the author's profile
cover
Video cover/thumbnail URL
dynamic_cover
Animated cover URL
origin_cover
Original cover frame URL
video_url
Watermark-free playback/download URL (temporary)
video_url_watermarked
Watermarked playback URL (temporary)
size
File size of the watermark-free video in bytes
size_watermarked
File size of the watermarked video in bytes
images
Image URLs for photo posts; empty for videos
music_id
ID of the sound used
music_title
Title of the sound used
music_author
Artist of the sound used
music_url
Playback URL of the sound
music_cover
Cover image of the sound
music_album
Album of the sound, or empty string
music_original
Whether the sound is an original sound
music_duration
Sound duration in seconds
mentioned_user_ids
Numeric IDs of the users mentioned in the caption
sentiment
Emotion analysis: emotions, dominant_emotion, emotional_intensity, polarity (when get_sentiment=true)
hashtag
The hashtag name (empty when looked up by hashtag_id)
hashtag_id
The hashtag's numeric ID
pages
Number of pages returned
count
Number of results returned

Example Request

curl "https://apidirect.io/v1/tiktok/hashtag/videos?name=cooking&pages=2"   -H "X-API-Key: YOUR_API_KEY"

Example Response

{
  "videos": [
    {
      "video_id": "7692609313717636383",
      "title": "#recipes #EasyRecipe #cooking #DinnerIdeas",
      "url": "https://www.tiktok.com/@cooking_recipescr/video/7692609313717636383",
      "date": "2026-10-04 00:49:32",
      "date_timestamp": 1791074972,
      "author": "cooking_recipescr",
      "source": "TikTok",
      "domain": "tiktok.com",
      "snippet": "#recipes #EasyRecipe #cooking #DinnerIdeas",
      "region": "US",
      "play_count": 431691,
      "likes": 5002,
      "comments": 108,
      "shares": 1638,
      "downloads": 449,
      "saves": 3558,
      "duration": 1435,
      "is_ad": false,
      "is_pinned": false,
      "author_name": "cooking_recipescr",
      "author_id": "7352666564073833515",
      "author_avatar": "https://p16-common-sign.tiktokcdn-eu.com/.../avatar.jpeg",
      "author_url": "https://www.tiktok.com/@cooking_recipescr",
      "cover": "https://p16-common-sign.tiktokcdn-eu.com/.../cover.jpeg",
      "dynamic_cover": "https://p16-common-sign.tiktokcdn-eu.com/.../dynamic_cover.webp",
      "origin_cover": "https://p16-common-sign.tiktokcdn-eu.com/.../origin_cover.jpeg",
      "video_url": "https://v19.tiktokcdn-eu.com/.../video.mp4",
      "video_url_watermarked": "https://v19.tiktokcdn-eu.com/.../video_wm.mp4",
      "size": 10246341,
      "size_watermarked": 9402354,
      "images": [],
      "music_id": "7692609536951110431",
      "music_title": "original sound - cooking_recipescr",
      "music_author": "cooking_recipescr",
      "music_url": "https://sf16-music.tiktokcdn-eu.com/.../music.mp3",
      "music_cover": "https://p16-common-sign.tiktokcdn-eu.com/.../music_cover.jpeg",
      "music_album": "",
      "music_original": true,
      "music_duration": 1420,
      "mentioned_user_ids": []
    }
  ],
  "hashtag": "cooking",
  "hashtag_id": "18973",
  "pages": 2,
  "count": 40
}

Frequently asked questions

Can I look up a hashtag by URL or ID?

Yes. Provide exactly one of name, hashtag_id, or url.

How many videos can I get?

Each page returns about 20 videos; request as many pages as you need.

How does pricing work?

You only pay for successful requests. The TikTok Hashtag Videos API costs $0.006 per page. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 10 simultaneous requests per endpoint per user. If you need more, just get in touch.

Start using the TikTok Hashtag Videos API

Get your API key and start making requests in minutes. 50 requests/month free every month.

Get API Key