TikTok Videos Scraper Actor

Extract video data from public TikTok user profiles and optionally download videos without watermarks.

Overview

This Apify actor scrapes TikTok user profiles using browser automation to handle anti-scraping measures. It returns structured data for each video and can download the video files directly.

Key Features

• User Profile Scraping: Pull videos from any public TikTok user by username.
• Customizable Limits: Scrape between 1 and 1000 videos per run.
• Video Downloads: Optional download of videos without TikTok watermarks.
• Proxy Support: Built-in configuration to use proxies and avoid IP blocking.
• Structured Output: Returns clean JSON data for easy parsing and integration.
• Cloud Execution: Designed to run on the Apify platform.

Input Parameters

Configure the actor with these parameters:

Output Format

The actor outputs an array of items, each containing structured data for a video. Example:

{
  "video_id": "7082906851540274478",
  "Video_url": "https://www.tiktok.com/@user/video/7082906851540274478",
  "createTime": "2 days ago",
  "Description": "This is a sample video description",
  "User_id": "68285123456789",
  "Username": "sampleuser",
  "Verified": true,
  "privateAccount": false,
  "Userbio": "Sample user bio",
  "stats_diggCount": 150000,
  "shareCount": 2500,
  "commentCount": 1200,
  "playCount": 2000000,
  "repostCount": 500,
  "followingCount": 120,
  "followerCount": 1500000,
  "heartCount": 50000000,
  "videoCount": 250,
  "authorStats_diggCount": 1000000,
  "friendCount": 45,
  "video_path": "/path/to/downloaded/video.mp4"
}

How to Use

On the Apify Platform

1. Go to the TikTok Videos Scraper Actor page.
2. Click "Try for free" or "Run".
3. Configure the input parameters: enter a username, set the videoCount, and toggle downloadVideos.
4. Click "Start" to run the actor. Results will be available in the dataset.

Running Locally

1. Install the Apify CLI: npm -g install apify-cli
2. Clone the actor's repository and navigate into it.
3. Install Python dependencies: pip install -r requirements.txt
4. Install browser binaries: playwright install
5. Create an input.json file:
   json { "username": "khaby.lame", "videoCount": 10, "downloadVideos": false }
6. Run the actor: apify run --input-file=input.json

Limitations & Troubleshooting

• Public Profiles Only: The actor only works with public TikTok accounts.
• Rate Limiting: TikTok may block requests. Using the proxy configuration (useApifyProxy: true) is strongly recommended.
• Download Reliability: Video downloading depends on third-party services and may occasionally fail.
• Storage: Downloading many videos consumes significant storage.

Common fixes:
- Empty results: Double-check the username and ensure the profile is public.
- Download failures: Try running with downloadVideos set to false to scrape metadata only.
- Timeout errors: Reduce the videoCount.

For more details, see the Apify documentation. Pricing is pay-per-result, based on successful runs.