joeyism / tiktok-scraper

A scraper to download TikTok videos

TikTok Scraper

Installation

To install with pip, run

pip3 install tiktok-scraper

Simple Usage

To use it with default settings, the latest version of Chrome is required. After which, you can run

tiktok-scraper <USERNAME>

which downloads locally to a folder with the same name as the username

API

usage: tiktok-scraper [-h] [--driver DRIVER] [--driver-type DRIVER_TYPE]
                      [--show-browser] [--delay DELAY] [--location LOCATION]
                      username
positional arguments:
  username              The TikTok username

optional arguments:
  -h, --help            show this help message and exit
  --driver DRIVER       Driver location
  --driver-type DRIVER_TYPE
                        Type of driver (i.e. Chrome)
  --show-browser        Shows browser while scraping. Useful for debugging
  --delay DELAY         Number of seconds to delay between video downloading
  --location LOCATION   Location to store the files

OPTIONS

--driver        Location of the driver (i.e. ./chromedriver). If not specified, it checks in `$PATH` first, and if it's not in there, a chromedriver is downloaded locally

--driver-type   Type of driver (i.e. Chrome, Firefox)

--show-browser  If set, the scraping is done with showing the browser. This is useful for debugging why sometime scraping may fail

--delay         The number of seconds to delay between video downloading. This may be important if there's a rate limit

--location      Location of where the videos are downloaded. If not specified, location is the same as the username 

tiktok-scraper's Issues

Download timeout

Downloads timeout after 72 videos, is it some hardcoded limit?

No videos downloaded

The chrome browser opens but it appears the scraper stops before the videos have time to load on the page. With the --show-browser option the blue and red loading indicator on the site appears but then the page closes. The result is no videos downloaded.

Edit: After trying the driver for Firefox the browser stayed open but I noticed the videos never load on the page. The browser stays open but the scraper exits in the console.

is this still working?

@joeyism Thank you for your contribution:)

I was wondering if anyoe has managed to get it working? I know these stopped worked recently due to changed in tiktok