TikTok Hashtag Scraper
Pricing
Pay per usage
TikTok Hashtag Scraper
Meet the TikTok Hashtag Scraper! This actor quickly scrapes and downloads videos from any hashtag. It provides high-quality videos without watermarks. For the fastest possible download speeds, it is highly recommended to disable proxies. Get all the TikTok content you need, fast and clean.
Pricing
Pay per usage
Rating
5.0
(1)
Developer
Shahid Irfan
Maintained by CommunityActor stats
1
Bookmarked
26
Total users
0
Monthly active users
11 days ago
Last modified
Categories
Features
Share
What does TikTok Hashtag Scraper do?
TikTok Hashtag Scraper collects video details from TikTok hashtag pages. Enter one or more hashtags, and the Actor searches each hashtag, finds the videos shown there, and saves their public metadata to an Apify dataset.
The result is a structured list you can sort, filter, export, and connect to other tools. Each record tells you which hashtag produced the video, so a single run can cover several topics at once. Set the number of results wanted to control how many records the run saves.
Why use TikTok Hashtag Scraper?
- Research hashtags in bulk - Add several hashtags in one run instead of opening each page by hand.
- Structured output - Every video becomes one dataset row with consistent field names.
- No video downloads - The Actor collects metadata only, so runs finish faster and use less storage.
- Export ready - Download results as JSON, CSV, Excel, or XML, or read them through the Apify API.
- Automation ready - Schedule runs to track hashtags over time or trigger workflows with webhooks.
What data can you extract from TikTok?
| Field | Description |
|---|---|
hashtag | Hashtag that produced the video |
video_id | Unique TikTok video identifier |
title | Video caption or title |
author | TikTok username of the creator |
publish_date | Upload date in YYYYMMDD format |
duration | Video length in seconds |
view_count | Number of views |
like_count | Number of likes |
description | Full video description |
thumbnail | Thumbnail image URL |
url | Direct TikTok video URL |
collected_at | ISO timestamp for when the record was saved |
How to use TikTok Hashtag Scraper
- Open the Actor on Apify Store.
- Add one or more hashtags without the
#symbol. - Set the number of results wanted and, if needed, a proxy configuration.
- Run the Actor.
- Open the dataset to review the videos and their metadata.
- Download the dataset or connect it to your workflow.
A hashtag can contain letters, numbers, and underscores. Spaces, punctuation, and the # symbol are not required and are cleaned from valid entries. Invalid hashtags stop the run with a clear validation message.
Input Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
hashtags | Array of strings | No | ["funny"] | Hashtags to search, without the # symbol |
resultsWanted | Integer | No | 20 | Maximum video records to save across all hashtags |
proxyConfiguration | Object | No | {} | Proxy settings. Empty means no proxy. Choose Apify Proxy or add custom proxy URLs in the form |
Hashtags are optional because the Actor has a default example. Add your own list to replace it. The Actor always collects metadata and does not download video files.
Output Data
| Field | Type | Description |
|---|---|---|
hashtag | String | Hashtag that produced the video |
video_id | String | Unique TikTok video identifier |
title | String | Video caption or title |
author | String | Creator username |
publish_date | String | Upload date in YYYYMMDD format |
duration | Number | Video length in seconds |
view_count | Number | Views at collection time |
like_count | Number | Likes at collection time |
description | String | Full video description |
thumbnail | String | Thumbnail image URL |
url | String | Direct TikTok video URL |
collected_at | String | ISO timestamp for when the record was saved |
Only public videos are saved. If a video is private, restricted, or no longer available, it is skipped and the run continues. The final log line reports how many videos were skipped.
TikTok's public hashtag page exposes a limited set of videos. If fewer videos are available than resultsWanted, the Actor also checks TikTok's topic page for the same hashtag, merges any new videos, and logs when no more public videos are returned.
Usage Examples
Search one hashtag
Collect up to 50 videos from a single hashtag page:
{"hashtags": ["funny"],"resultsWanted": 50}
Search several hashtags
Collect videos from multiple topics in the same run:
{"hashtags": ["funny", "cats", "cooking"],"resultsWanted": 100}
Use Apify Proxy
Proxy is off by default. Turn it on from the Proxy configuration field when you need a different network exit:
{"hashtags": ["funny"],"resultsWanted": 20,"proxyConfiguration": {"useApifyProxy": true}}
Mixed casing and prefixes
Hashtags are normalized to lowercase, and a leading # is accepted:
{"hashtags": ["#FYP", "StreetFood", "dance_challenge"],"resultsWanted": 30}
Sample Output
{"hashtag": "funny","video_id": "7706305917662268703","title": "When the joke lands at the wrong time #funny #comedy","author": "example_creator","publish_date": "20260728","duration": 23,"view_count": 1854000,"like_count": 142300,"description": "When the joke lands at the wrong time #funny #comedy","thumbnail": "https://p16-sign-va.tiktokcdn.com/example-thumbnail.jpg","url": "https://www.tiktok.com/@example_creator/video/7706305917662268703","collected_at": "2026-07-28T10:30:00+00:00"}
Tips for Best Results
- Use popular hashtags. Hashtags with little or no public content return an empty dataset.
- Set
resultsWantedto the number of records you need. The cap applies across all hashtags in the run. - Keep the list focused. A run processes videos for each hashtag until the result cap is reached.
- Videos that appear under more than one of your hashtags are saved once.
- Leave proxy off for the fastest run. Enable it only when you need a different network exit.
- View, like, and publish values reflect what TikTok returned when the record was collected.
- If a hashtag returns no videos, try it again later or test a broader hashtag.
- Missing fields are a source limitation. Not every video publishes every value.
Integrations
- Google Sheets - Send dataset rows to a spreadsheet for review and reporting.
- Webhooks - Trigger a workflow when a run finishes.
- Make or Zapier - Connect results to no-code automations.
- API - Read datasets programmatically from your own systems.
- Apify schedules - Re-run selected hashtags hourly, daily, or weekly.
Frequently Asked Questions
Does this Actor download TikTok videos?
No. It collects public video metadata only. The dataset does not include video files or download links.
Can I search more than one hashtag in a single run?
Yes. Add each hashtag to the hashtags array. Every hashtag is searched, and each saved record names the hashtag that produced it.
How many videos does one hashtag return?
The resultsWanted value caps the total number of records saved in the run. TikTok's public hashtag page only exposes a limited set of videos, so the Actor also checks TikTok's topic page for the same hashtag and merges new videos. If the cap still is not reached, it saves everything it found and logs that no more public videos were returned.
Why is the dataset empty?
The hashtag may have no public videos, may be restricted, or TikTok may have returned a page without video links. Try a more popular hashtag or run the Actor again later.
Is a proxy required?
No. Proxy is off by default. The Actor fetches public hashtag pages without one. If you enable proxy and the proxy returns no videos, the Actor retries the hashtag without it.
What happens to private or unavailable videos?
They are skipped. The dataset contains only public video details, and the final log reports how many videos were skipped during the run.
Why are some fields empty?
TikTok does not publish every value for every video. A missing view, like, or thumbnail value is reported as an empty field rather than invented.
Can I export the data to CSV or Excel?
Yes. Apify datasets can be downloaded in CSV, Excel, JSON, XML, and other supported formats after a run.
Can I run this Actor on a schedule?
Yes. Create a schedule in Apify Console and choose the input hashtags. Scheduled runs keep a history of results in separate datasets.
Is it legal to collect TikTok data?
Collecting publicly available data can be legal, but rules differ by location and use case. You are responsible for complying with applicable laws, TikTok's terms, and privacy requirements.
Support
For issues, feature requests, or custom Actor work, use the Issues tab on the Actor page or contact the developer through Apify.
Legal Notice
This Actor is designed for legitimate collection of publicly available data. Users are responsible for using the data responsibly and complying with applicable laws and website terms.