TikTok Scraper & Downloader

Scrape and download useful information from TikTok.

No login or password are required

This is not an official API support and etc. This is just a scraper that is using TikTok Web API to scrape media and related meta information.

---

---

Content

• Features
• To Do
• Contribution
• Installation
• Usage
  • In Terminal
    • Terminal Examples
    • Manage Download History
    • Scrape and Download in Batch
    • Output File Example
  • Docker
    • Build
    • Run
  • Module
    • Methods
    • Options
    • Use with Promises
    • Use with Events
    • How to get/set session value
    • How to access/download video
    • Output Example
      • Video Feed Methods
      • getUserProfileInfo
      • getHashtagInfo
      • getVideoMeta
      • getMusicInfo

Important notes

• As of right now it is NOT possible to download video without the watermark

Features

• Download unlimited post metadata from the User, Hashtag, Trends, or Music-Id pages
• Save post metadata to the JSON/CSV files
• Download media with and without the watermark and save to the ZIP file
• Download single video without the watermark from the CLI
• Sign URL to make custom request to the TikTok API
• Extract metadata from the User, Hashtag and Single Video pages
• Save previous progress and download only new videos that weren't downloaded before. This feature only works from the CLI and only if download flag is on.
• View and manage previously downloaded posts history in the CLI
• Scrape and download user, hashtag, music feeds and single videos specified in the file in batch mode

To Do

• CLI: save progress to avoid downloading same videos
• Rewrite everything in TypeScript
• Improve proxy support
• Add tests
• Download video without the watermark
• Indicate in the output file(csv/json) if the video was downloaded or not
• Build and run from Docker
• CLI: Scrape and download in batch
• CLI: Load proxies from a file
• CLI: Optional ZIP
• Renew API
• Set WebHook URL (CLI)
• Add new method to collect music metadata
• Add Manual Pagination
• Improve documentation
• Download audio files
• Web interface

Contribution

• Don't forget about tests

yarn test

yarn build

Installation

tiktok-scraper requires Node.js v10+ to run.

Install from NPM

npm i -g tiktok-scraper

Install from YARN

yarn global add tiktok-scraper

USAGE

In Terminal

$ tiktok-scraper --help

Usage: tiktok-scraper <command> [options]

Commands:
  tiktok-scraper user [id]     Scrape videos from username. Enter only username
  tiktok-scraper hashtag [id]  Scrape videos from hashtag. Enter hashtag without #
  tiktok-scraper trend         Scrape posts from current trends
  tiktok-scraper music [id]    Scrape posts from a music id number
  tiktok-scraper video [id]    Download single video without the watermark
  tiktok-scraper history       View previous download history
  tiktok-scraper from-file [file] [async]  Scrape users, hashtags, music, videos mentioned
                                in a file. 1 value per 1 line