TikTok Hashtag Scraper for Public Videos

Discover public TikTok videos by hashtag and export captions, creators, engagement, dates, media links, and hashtag-level statistics without a TikTok login or official API key.

What this Actor does

The Actor resolves each submitted hashtag, reads its public metadata, paginates available videos, and saves one Dataset item per unique video. You can request video rows or metadata-only hashtag snapshots. Every result reports collection completeness and why pagination stopped.

Use cases

• Discover creators and videos around a topic, event, or campaign.
• Analyze hashtag activity, engagement, captions, and related topics.
• Monitor trends and compare public content categories.
• Build public-video datasets for research or reporting.

How to use

1. Add one or more hashtags with or without the # prefix.
2. Keep includeVideos enabled for video-level rows.
3. Set per-hashtag and total video limits.
4. Start the Actor and export the Dataset.

Input

hashtags is required. Values are normalized and duplicates are skipped. maxVideosPerHashtag limits rows for each hashtag; maxTotalVideos caps video rows across the complete run. When includeVideos is false, the Actor returns hashtag metadata instead of individual videos. includeRaw adds source payload data and can substantially increase item size.

This exact input produced the complete output below:

{
  "hashtags": [
    "#marketing"
  ],
  "includeVideos": true,
  "maxVideosPerHashtag": 1000,
  "maxTotalVideos": 1000,
  "includeRaw": false
}

Output

Video rows contain hashtag context, collection status, video identity, caption, creator, engagement, duration, and request status. Metadata-only and error rows have distinct recordType and status values. videoCollection.complete and stopReason explain whether all currently exposed pages were exhausted or a configured boundary stopped collection.

This is the complete first Dataset item from a real successful run:

{
  "recordType": "video",
  "success": true,
  "status": "ok",
  "source": "hashtag_api_xbogus",
  "retrievedAt": "2026-08-18T12:00:34.489377Z",
  "input": "#marketing",
  "sourceType": "hashtag",
  "hashtag": "marketing",
  "hashtagUrl": "https://www.tiktok.com/tag/marketing",
  "challengeId": "2543007",
  "title": "marketing",
  "hashtagDescription": null,
  "cover": null,
  "hashtagStats": {
    "videoCount": 9208640,
    "viewCount": 72328050646
  },
  "relatedHashtags": [],
  "videoCollection": {
    "requested": 1000,
    "returned": 145,
    "pages": 6,
    "hasMore": false,
    "complete": true,
    "stopReason": "SOURCE_EXHAUSTED"
  },
  "videoIndex": 1,
  "videoId": "7621179161448664323",
  "videoUrl": "https://www.tiktok.com/@theoryofkhaos/video/7621179161448664323",
  "description": "How to Build a Cult Brand (Part 4/4 ) 😈♟️ Psychology says your customers don't want more marketing from you. They want a brand world they can belong to. Cult brands create entire worlds through 3 layers: 1️⃣ Content  Create content about the brand world, not just the product 2️⃣ Campaigns Design campaigns that become stories people retell 3️⃣ Experiences Build spaces where your brand community gathers and connects Why this works ⬇️ 💭 Third spaces are disappearing. 💭 Your customers are LONELY. Brands that fill this gap don't just win customers, they become cult favourites ;) #branding #cultbranding #brandstrategy #brandpsychology",
  "hashtags": [
    "branding",
    "brandpsychology",
    "brandstrategy",
    "cultbranding"
  ],
  "createdAt": 1774444057,
  "createdAtISO": "2026-03-25T13:07:37Z",
  "author": {
    "username": "theoryofkhaos",
    "nickname": "Yasmin | Strategy & Design",
    "userId": "7261216191103353882",
    "verified": false,
    "secUid": "MS4wLjABAAAAi5XtvymAw3jiLoHhp06o0wJEShKZQYi81S1qcZTO-zqXx517Jsrr0TzuyyjqXxt9"
  },
  "stats": {
    "views": 36600,
    "likes": 3375,
    "comments": 58,
    "shares": 572,
    "saves": 2606
  },
  "duration": 119,
  "request": {
    "detailEndpoint": "https://www.tiktok.com/api/challenge/detail/",
    "itemsEndpoint": "https://www.tiktok.com/api/challenge/item_list/",
    "detailStatus": 200,
    "itemsStatus": 200,
    "detailBytes": 756,
    "itemsBytes": 4363965,
    "itemsPages": 6,
    "itemsHasMore": false,
    "itemsCursor": "153",
    "signature": "X-Bogus",
    "msTokenGenerated": true,
    "attempts": 1
  }
}

Pricing

You pay only for each unique video row successfully saved. The effective price depends on your Apify plan:

Plan tier	Price per video	Equivalent per 1,000 videos
FREE	$0.001	$1.00
BRONZE	$0.0009	$0.90
SILVER	$0.0008	$0.80
GOLD	$0.00075	$0.75
PLATINUM	$0.00075	$0.75
DIAMOND	$0.00075	$0.75

Diagnostic rows, hashtag metadata, errors, duplicates, and run summaries are not charged as video results. Apify platform usage can still apply according to your plan.

Related Actors

Actor	Best for
TikTok Comments Scraper – No Login	Collecting public conversations from videos discovered by hashtag.
TikTok Profile Scraper – Bio, Stats & Playlists	Enriching creators discovered in hashtag results.
TikTok Profile Videos Scraper – No Login	Expanding from a discovered creator to their public video feed.

Limits and data quality

Configured limits are maxima, not guaranteed counts. TikTok may expose fewer videos than its displayed hashtag counter, and availability, ordering, or engagement totals can change. Private, removed, regional, or restricted content cannot be returned. A SOURCE_EXHAUSTED result means the currently exposed pagination ended; it does not guarantee access to every historical video using that hashtag.

Frequently asked questions

Should hashtags include #?

Either form is accepted and normalized.

Can I collect only hashtag statistics?

Yes. Set includeVideos to false.

Are videos downloaded?

No. Results contain available public video URLs and metadata.

Responsible use

Use the Actor only with public information and for lawful purposes. Respect TikTok's terms, applicable privacy and marketing laws, copyright, and the rights of creators represented in the Dataset.

Support

Open an issue in the Actor's Issues tab with the run ID, hashtag, collection stop reason, and a small affected result. Never include passwords, tokens, or private credentials.