skills.rest
jcrabapple
jcrabappleCOMMUNITY
Explore all skills by this author →
GitHub

nanogpt-tiktok

Scrape TikTok videos, hashtags, profiles, and ASR transcripts through the NanoGPT API.

10|2|Updated May 6, 2026
Search Tags:#transcript#API#social media#TikTok#scraping#nanogpt#Hashtag research
One-click install
npx skills add https://github.com/jcrabapple/hermes-skills --skill nanogpt-tiktok-jcrabapple
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nanogpt-tiktok
Source: https://github.com/jcrabapple/hermes-skills/tree/main/nanogpt-tiktok
Command: npx skills add https://github.com/jcrabapple/hermes-skills --skill nanogpt-tiktok-jcrabapple

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Collecting TikTok content for research, trend analysis, or content pipelines normally requires building and maintaining a custom scraper against TikTok's anti-bot defenses. This Skill routes scraping through NanoGPT's managed TikTok scraper API, returning structured video metadata, engagement metrics, comments, and full ASR transcripts using a single API key. ## Core Features & Use Cases - Four source modes: scrape by hashtag, profile username, keyword search, or direct video URL, with filters for date range, like counts, and proxy country. - Transcript extraction: fetch TikTok's auto-generated ASR subtitles as clean plain text via the CDN tiktokLink, with optional paid transcription for videos missing subtitles. - Rich metadata and media: engagement counts (likes, views, shares, bookmarks), creator info, music tracks, hashtags, and optional downloads of videos, covers, and avatars. - Use Case: A researcher asks the agent to scrape a TikTok URL, pull its transcript, and feed the content into a deep-research or note-taking workflow — all billed through an existing NanoGPT account at roughly $0.005 per video. ## Quick Start Load the nanogpt-tiktok skill and scrape this TikTok URL with its transcript: https://www.tiktok.com/t/ZTkngGoyg/

Frequently Asked Questions about nanogpt-tiktok

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scrape a TikTok video and get its transcript?▼

Run the CLI with the video URL and the --show-transcript flag: ./scripts/scrape_tiktok.py --urls "https://www.tiktok.com/t/ZTkngGoyg/" --show-transcript. It fetches the WebVTT subtitle file from the response's subtitleLinks tiktokLink and returns clean plain text.

How to search TikTok by hashtag or keyword via API?▼

Use --hashtags ai,python or --search "machine learning" with the scrape_tiktok.py CLI, which posts to NanoGPT's /api/v1/tiktok endpoint. You can add filters like --min-hearts, --after, and --results to narrow the result set.

What API key do I need for TikTok scraping with NanoGPT?▼

You need a NanoGPT account API key set as the NANOGPT_API_KEY environment variable or stored in ~/.config/nanogpt/.env. No separate TikTok or Apify credentials are required since scraping runs on NanoGPT's infrastructure.

How much does it cost to scrape TikTok through NanoGPT?▼

A single video URL scrape costs about $0.0048, covering the result and actor-start fees. Transcription from scratch costs $0.0492 per minute and requires a maxTotalChargeUsd of at least $0.60; downloading existing ASR subtitles is much cheaper.

Why does the TikTok subtitle URL look like a video file?▼

The subtitleLinks tiktokLink points to TikTok's video CDN and may report a video/mp4 content type, but a GET request actually returns WebVTT subtitle text. Fetch it promptly after scraping because CDN URLs can expire.

What are the limitations of scraping TikTok via this API?▼

Results can be limited by TikTok's anti-scraping measures, and large jobs need a higher waitForFinishSecs value. The --raw and --show-transcript flags are incompatible, and browser-based reading of TikTok pages is discouraged because recommended videos contaminate the data.

Related Skills

Explore More Data & Analytics Skills→
orthogonal-shorthogonal-sh
12

tiktok-search

Scrapes TikTok profiles, videos, and hashtags via Orthogonal's Scrape Creators API.

Official
Intermediate
guccangguccang
3

blogwatcher

Monitor RSS/Atom feeds and track unread articles.

Community
Intermediate
glowingkittyglowingkitty
43

analyze-video

Extract factual claims from YouTube transcripts and assess bias via web search.

Community
Advanced
Growth4U-systemsGrowth4U-systems

social-media-extractor

Extract posts, hashtags, and profiles from Instagram, TikTok, and Reddit using Apify actors.

Official
Advanced