TikTok Hashtag Scraper

Scrape the videos of any TikTok hashtag as clean, structured data, with far more videos per hashtag than one TikTok feed shows.

Add hashtags, choose how many videos you need from each, and export the results as JSON, CSV or Excel, or pull them through the Apify API. Results appear in your dataset while the run is still going.

What This Actor Does

• Collects the videos of each hashtag with views, likes, comments, shares, saves, caption, hashtags, mentions, music, cover image, video link and subtitle links, plus the author's full profile
• Deep results: popular hashtags typically give 800 to 1,200+ unique videos, far more than you can scroll on TikTok's hashtag page
• Collects each video's comments and replies with one switch, in their own table
• Date filters, view and like filters, sorting, subtitles and country selection are included at no extra cost

Best For

• Trend research and content ideas
• Finding creators who post about a topic
• Brand, campaign and challenge monitoring
• Collecting comments under a hashtag for sentiment analysis
• Building datasets for dashboards, BI or AI workflows

Input

Field	What it does
hashtags	Hashtags, with or without #, e.g. gymtok, #booktok
startUrls	Hashtag links, e.g. https://www.tiktok.com/tag/booktok
resultsPerPage	How many videos to collect from each hashtag (default 100)
newerThan / olderThan	Only videos from a date range. Accepts a date (2026-06-01) or a relative period (7 days, 3 months)
minViews / minLikes	Only videos above a popularity threshold
sortBy	default, newest, oldest, mostViewed, mostLiked, mostShared
includeComments	Also collect the comments of every video (paid add-on)
maxCommentsPerVideo	How many comments per video
includeReplies	Also collect replies to comments (charged as comments)
includeSubtitles	Add the subtitle text of each video
country	Show videos as TikTok ranks them in this country first (default United States)

Example input

{
  "hashtags": ["gymtok", "#booktok"],
  "resultsPerPage": 500,
  "newerThan": "3 months",
  "sortBy": "mostViewed"
}

Output

Each run has two tables, both on the run's Output tab:

• Videos (main table): one row per video or photo post. source shows which hashtag each video came from.
• Comments & replies: filled only when Include comments is on. Every row carries videoId, videoUrl, videoAuthor and videoCaption, so it links back to its video.

Every field is included when you export or use the API.

Video fields

Field	Description
id, url	Video ID and link
text, language	Caption and its language
createdAt	Upload time (ISO 8601)
viewCount, likeCount, commentCount, shareCount, saveCount, repostCount	Engagement
durationSeconds, width, height, definition, format	Video details
coverUrl, originalCoverUrl, videoUrl, downloadUrl, images	Cover, video file links, and all images of a photo post
isPinned, isPhotoPost, isAd, isSponsored, isAiGenerated, hasShopProduct	Flags
hashtags, hashtagDetails, mentions, mentionedUsers, effects	Hashtags (with IDs), mentioned users (with IDs) and effects used
location	The tagged place, when there is one
music	Sound ID, title, author, album, original-sound flag, cover, links
hasSubtitles, subtitleLinks, subtitles	Subtitle availability, links per language, and text when enabled
author	The creator's full profile: username, name, bio, followers, likes
source	The hashtag the video came from

Example output

A video row (author shortened):

{
  "type": "video",
  "id": "7111798235991264558",
  "url": "https://www.tiktok.com/@bellaanya/video/7111798235991264558",
  "text": "For my gym anxiety gals #fyp #workout #squats #squat #squatrack #squatracktips #greenscreenvideo #greenscreen #gymgirls #gymtok",
  "createdAt": "2022-06-21T20:49:22Z",
  "viewCount": 9000000,
  "likeCount": 1100000,
  "commentCount": 1010,
  "shareCount": 1114,
  "saveCount": 73131,
  "durationSeconds": 42,
  "hashtags": [
    "fyp",
    "workout",
    "squats",
    "squat",
    "squatrack",
    "squatracktips",
    "greenscreenvideo",
    "greenscreen",
    "gymgirls",
    "gymtok"
  ],
  "music": {
    "title": "original sound",
    "authorName": null
  },
  "author": {
    "username": "bellaanya",
    "followerCount": 319800,
    "verified": false
  },
  "source": {
    "type": "hashtag",
    "value": "gymtok"
  }
}

How To Use

1. Add one or more hashtags.
2. Set Maximum videos per hashtag.
3. Optionally add date or popularity filters, a sort order, or comments.
4. Run the Actor and open the Output tab, export the results, or read them through the Apify API.

Pricing

This Actor uses pay-per-event pricing, so you only pay for results you receive:

• Video: each video or photo post saved to your dataset
• Comment: each comment or reply saved, only when you turn comments on
• Actor start: a small fee each time a run starts

Filters, sorting, subtitles and country selection are included at no extra cost, and you are charged only for videos that pass your filters. Current prices for each Apify plan are shown on the Actor's Pricing tab.

If a run reaches the maximum cost you set for it, it stops cleanly and keeps everything collected so far.

Free plan

On the Apify free plan every feature is available to try, with smaller amounts per run: up to 3 hashtags, 10 videos per hashtag, 10 comments per video and 3 replies per comment. Upgrade to a paid Apify plan to remove these limits.

Best Practices

• Start with a small Maximum videos per hashtag to check the output quickly.
• For monitoring, use Only videos newer than (for example 7 days) on a schedule.
• Use Most viewed sorting to get the top videos of the videos collected.

FAQ

How many videos can I get from one hashtag?

Typically 800 to 1,200+ unique videos for a popular hashtag, and fewer for small ones. Every video is saved once, without duplicates.

Why did a hashtag return fewer videos than I asked for?

The hashtag may be small, or fewer videos matched your date or popularity filters. The run log tells you when that happens.

Why are some videos missing the exact hashtag in their caption?

TikTok's own hashtag page also shows closely related videos. This Actor returns exactly what TikTok shows for the hashtag.

How long does a run take?

Most runs finish in under a minute: three hashtags with 600 videos each took about 65 seconds in our tests.

Responsible Use

This Actor collects publicly available data only. Make sure your use complies with TikTok's terms, applicable laws and data-protection rules such as the GDPR, especially when you process personal data.

Troubleshooting

• A hashtag could not be found: check the spelling. Hashtags have no spaces.
• No videos from a hashtag: the hashtag may be empty or blocked by TikTok, or nothing matched your filters.
• A link was skipped: this Actor accepts hashtag links only. Use the TikTok Scraper for profiles, videos and search.

If something still does not work, open an issue on the Actor's Issues tab with your run link and we will take a look.