⚡ High-Performance TikTok Scraper & Agent Discovery

Scrape TikTok Videos, Profiles & Trends from Your Terminal

A native, sub-3ms Rust CLI for scraping videos, hashtags, profiles, and search results via Apify. Built for data pipelines and LLM agent consumption.

# Install via Cargo
$ cargo install --git https://github.com/SpaceCorps/TikTok-Cli --locked
# Authenticate interactively via Apify token
$ tiktok login
# Scrape videos from a creator profile
$ tiktok profile nike --limit 10
# Scrape trending videos by hashtag
$ tiktok hashtag "coding" --limit 5
# Search TikTok for user accounts in JSON mode
$ tiktok search "tech" --users --profiles 5 --json

Engineered for Developers & AI Agents

Combining the reliability of Apify scrapers with the speed of native Rust.

⚡

Sub-3ms Cold Starts

Single standalone static binary compiled with Rust 2024. Zero interpreter startup overhead, zero virtual environment lags.

🤖

Agentic Protocol

Clean YAML output by default for humans, structured JSON with --json for agent tool loops, and deterministic exit codes.

🔒

Native OS Keystore

API tokens are stored in macOS Keychain, Windows DPAPI, or Linux Secret Service. Credentials never touch disk in plain text.

👥

Multi-Account Management

Isolate environments, teams, or client configurations with --account <name> and audit accounts with tiktok accounts list --check.

🔍

Deep Search & Discovery

Search video content, top trends, or creator profiles directly from the command line with tiktok search.

📊

Rich Metadata & Comments

Extract video URLs, captions, transcripts, sound IDs, engagement counts, and comment threads in clean structured output.

Command Reference

Intuitive commands designed for direct scripting and autonomous agent invocation.

Command Description Example
tiktok profile <USERNAMES> Scrape videos from TikTok profiles with sort, date, and comment filters. tiktok profile nike --limit 10
tiktok hashtag <HASHTAGS> Scrape videos by hashtag with limit and comments options. tiktok hashtag "coding" --limit 5
tiktok search <QUERIES> Search TikTok for videos or users (via --users). tiktok search "tech" --users --profiles 5
tiktok video <URLS> Scrape specific TikTok videos by URL and related videos. tiktok video https://www.tiktok.com/@u/video/123
tiktok accounts <SUB> Manage stored accounts (add, list, test, remove). tiktok accounts list --check
tiktok login [<NAME>] Interactive browser login saving token to native keystore. tiktok login
tiktok agent-readme Display the complete agent operating manual and exit code definitions. tiktok agent-readme --json