TikTok Videos Scraper

An Apify Actor for scraping TikTok videos by keyword, tag, or profile. It extracts detailed metadata for each matching video.

Overview

This actor searches TikTok's public web interface and returns structured data about videos. You control the search type, quantity, and optional regional filtering.

Key Features

• Search Types: Find videos using a keyword, a specific hashtag, or from a user's profile.
• Rich Metadata: Extracts video details, author information, statistics, music data, and associated challenges.
• Configurable Output: Set the number of videos to retrieve and filter by region code (e.g., "US", "FR").

How to Use

1. Deploy the actor on the Apify platform.
2. Configure the input using the JSON structure below.
3. Run the actor. Results will be available in the actor's dataset.

Input Configuration

Provide a JSON object with these parameters:

{
  "size": 10,
  "queryType": "keyword",
  "text": "candle",
  "regionCode": "US"
}

• size: (Required) Number of videos to retrieve. Default is 10.
• queryType: (Required) Search method. Options: "keyword", "tag", or "profile".
• text: (Required) The search term (keyword, tag, or TikTok username).
• regionCode: (Optional) Two-letter region code to filter results (e.g., "US", "CA").

Output Data

The actor returns an array of video objects. Each object includes:

{
  "id": "123456789",
  "url": "https://www.tiktok.com/@example_user/video/123456789",
  "createTime": 1680000000,
  "desc": "Video description.",
  "autor": { "id": "987654321", "nickname": "Example User", "uniqueId": "example_user", "verified": true, ... },
  "authorStats": { "followerCount": 1000, "heartCount": 5000, ... },
  "challenges": [ { "id": "111", "title": "Example Challenge" } ],
  "music": { "id": "222", "title": "Example Music", "authorName": "Example Artist" },
  "stats": { "playCount": 10000, "likeCount": 500, "commentCount": 50, "shareCount": 10 },
  "textLanguage": "en",
  "video": { "duration": 30, "height": 1080, "width": 1920, "url": "https://example.com/video.mp4" }
}

Key fields: Video ID, URL, description, author details and stats, associated challenges and music, engagement statistics (plays, likes, comments, shares), and video properties including a direct URL.

Notes

• The actor scrapes TikTok's public interface.
• Ensure your input parameters correspond to existing content.
• Performance may be affected by TikTok's rate limits or restrictions.