tiktok-hashtag-videos
TikTok hashtag video scraper: input a hashtag name β output paginated video list with full metadata (author profile, engagement stats, music, video meta, hashtag list)
Install / Use
npx skills add browser-act/skills --skill tiktok-hashtag-videosInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OtherSupported Platforms
Our assessment of tiktok-hashtag-videos
tiktok-hashtag-videos scores 93/100 on our quality scale, 43rd of 330 Other skills we index (top 14%).
Its SKILL.md is 7.6 KB long, well organised into 16 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
With 6,001 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 3 months ago, so tiktok-hashtag-videos is actively maintained.
- Our last check on 2026-10-26 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit β read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-27. Automated pattern scan on 2026-09-27. It catches known dangerous patterns, not every risk β read a skill before letting an agent act on it.
tiktok-hashtag-videos compared with similar skills
All 4 of these similar skills score higher than tiktok-hashtag-videos; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| tiktok-hashtag-videos (this skill)by browser-act | 93 | 6.0k | 3mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
| crawl4aiby unclecode | 100 | 87.4k | 3d ago | MCP Server |
Frequently asked questions
- How do I install tiktok-hashtag-videos?
- Run
npx skills add browser-act/skills --skill tiktok-hashtag-videos. The install tabs above show the steps for each supported agent. - Which AI agents does tiktok-hashtag-videos work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is tiktok-hashtag-videos safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is tiktok-hashtag-videos still maintained?
- The repository was last updated about 3 months ago, so tiktok-hashtag-videos is actively maintained.
Skill content
View source on GitHubname: tiktok-hashtag-videos description: "TikTok hashtag video scraper: input a hashtag name β output paginated video list with full metadata (author profile, engagement stats, music, video meta, hashtag list). Use when user mentions TikTok hashtag scraping, TikTok tag videos, scrape TikTok by hashtag, extract TikTok hashtag data, TikTok challenge videos, get videos from a TikTok tag, bulk collect TikTok hashtag posts, TikTok video collection by tag, TikTok topic videos, collect TikTok tag data, batch fetch TikTok videos by hashtag, tiktok tag scraper, tiktok challenge scraper. Also applies to competitive research on TikTok trending topics, influencer discovery by hashtag, content monitoring for specific TikTok tags, or any task requiring video lists from a specific TikTok hashtag or challenge."
TikTok β Hashtag Videos
hashtag name β challenge info + paginated video list with author, engagement, music, and video metadata
Language
All process output to user (progress updates, process notifications) follows the user's language.
Objective
Extract the video list for a given TikTok hashtag using the /api/challenge/item_list/ endpoint triggered by page navigation.
Prerequisites
- Browser is open and can access
https://www.tiktok.com - No login required for public hashtag data
- Browser must use a non-HK proxy (TikTok has shut down in Hong Kong)
Pre-execution Checks
1. Tool Readiness
If browser-act has been confirmed available in the current session β skip this step.
Invoke browser-act via Skill tool to load usage. If installation or configuration issues arise, follow its guidance to resolve then retry.
Capability Components
This Skill's operational boundary = what the user can manually do in their browser. It only reads data already displayed to the user on the page, never bypassing authentication or access controls. JS code is encapsulated in Python files under the
scripts/directory, invoked viaeval "$(python scripts/xxx.py {params})".$(...)is bash syntax; it is recommended to use the bash tool for execution.
Below are all atomic capabilities discovered and verified during the exploration phase. Simply invoke them as needed β no need to read scripts/*.py source code or re-verify.
API: Get challenge ID from hashtag name
eval "$(python scripts/get-challenge-id.py '{hashtag}')"
Parameters:
{hashtag}: hashtag name without#, e.g.,fitness
Output example:
{
"id": "9261", // challengeID β required for item_list requests
"title": "fitness", // canonical hashtag title
"videoCount": "63107035", // total videos under this hashtag
"viewCount": "760591731095" // total views
}
Network Capture: Hashtag video list (parameters injected via URL navigation)
/api/challenge/item_list/ requires TikTok's dynamic signing (X-Bogus/X-Gnarly); direct fetch returns empty. Navigate to the hashtag page β TikTok's JS triggers the signed request automatically:
navigate https://www.tiktok.com/tag/{hashtag}wait stablenetwork requests --type xhr,fetch --filter "challenge/item_list"network request <id>
Endpoint characteristic: URL contains /api/challenge/item_list/ with cursor=0
Error handling: If no matching request is found after navigation, take a screenshot to confirm the page loaded correctly, then retry navigation once. If the page shows a region-restriction notice, switch to a browser with a non-HK proxy.
Output example:
{
"cursor": "30", // use as cursor value to identify next page's request
"hasMore": true, // false when all pages exhausted
"itemList": [
{
"id": "7212410220977392938",
"desc": "Daily Push Up Workoutπ#fitness #athlete",
"createTime": 1679270124,
"isAd": false,
"isPinned": false,
"locationCreated": "US",
"author": {
"uniqueId": "marcusriosofficial", // username for webVideoUrl
"nickname": "Marcus Rios",
"verified": false,
"signature": "Former NFL Athlete π",
"bioLink": null,
"avatarThumb": "https://...",
"privateAccount": false
},
"authorStats": {
"followerCount": 423500,
"followingCount": 50,
"heart": 10000000,
"videoCount": 1277,
"diggCount": 869
},
"stats": {
"diggCount": 367500,
"shareCount": 6041,
"playCount": 4500000,
"commentCount": 942,
"collectCount": 56691
},
"video": {
"duration": 48,
"height": 1280,
"width": 720,
"cover": "https://...",
"definition": "720p",
"format": "mp4"
},
"music": {
"id": "7176546707423889410",
"title": "Trap Money so Big (Remix)",
"authorName": "Iqbal12",
"original": false,
"coverMedium": "https://..."
},
"textExtra": [{"hashtagId": "9261", "hashtagName": "fitness"}],
"effectStickers": [],
"imagePost": null // non-null for slideshow posts
}
]
}
Network Capture: Hashtag video list pagination (page 2+)
After reading page 1, scroll down to trigger the next page request:
scroll downwait stablenetwork requests --type xhr,fetch --filter "challenge/item_list"- Find the request whose URL contains a
cursorvalue higher than the previous page (e.g.,cursor=30,cursor=60) network request <id>
Termination: hasMore is false in response, or itemList is empty.
Composite: Full hashtag extraction (challenge ID + paginated video list)
eval "$(python scripts/get-challenge-id.py '{hashtag}')"β recordidas challengeId (confirms hashtag exists)navigate https://www.tiktok.com/tag/{hashtag}βwait stablenetwork requests --filter "challenge/item_list"βnetwork request <id>β collectitemList, notecursorandhasMore- While
hasMoreistrue: a.scroll downβwait stableb.network requests --filter "challenge/item_list"β find new request (cursor changed) βnetwork request <id>c. CollectitemList, updatehasMore - Merge all collected
itemListarrays
Pagination
DOM Pagination: Scroll triggers new challenge/item_list requests. Each page returns 30 items. Cursor advances numerically (0 β 30 β 60...). Termination: hasMore === false or empty itemList.
Success Criteria
itemList.length >= 1 and first item has non-null id, stats.playCount, author.uniqueId
Known Limitations
- Requires non-HK proxy (TikTok shut down in Hong Kong)
challenge/item_listrequires dynamic signing β always use navigate + network captureget-challenge-id.py(challenge/detail) works via direct fetch without signing- Private or age-restricted hashtags may return empty
itemList - Page returns ~30 videos per scroll; high-volume extraction requires many scroll iterations
Execution Efficiency
- Batch orchestration: Loop through multiple hashtags serially in one session; do not parallelize within one browser. Add 2β3s intervals between navigations.
- Test before batch execution: Test with 1 hashtag first, then run the full batch.
- Error resumption: Save results page-by-page; resume from the last successful page on failure.
Experience Notes
Path: {working-directory}/browser-act-skill-forge-memories/tiktok-scraper-tiktok-hashtag-videos.memory.md
Before execution: If the file exists, read it first β it records unexpected situations from past executions; adjust strategy accordingly.
After execution: If an unexpected situation occurs (strategy failed, page redesigned, anti-scraping upgraded, better path found), append a line:
{YYYY-MM-DD}: {what happened} β {conclusion}
Normal execution does not write to the file.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu β one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
103.6kπ·οΈ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.4kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit β see the Safety scan above for what the skill file itself contains.
