TikTok Videos by Tag Scraper

Overview

This Apify Actor scrapes TikTok videos based on a specific hashtag. It returns detailed metadata for each video, including author information, engagement stats, and media details.

Key Features

• Fetches videos by TikTok tag/hashtag.
• Returns structured data for videos, authors, music, and challenges.
• Configurable limit on the number of videos to retrieve.
• Runs on the Apify platform, handling the scraping infrastructure.

How to Use

1. Deploy the Actor on Apify.
2. Configure the required input parameters (see below).
3. Run the Actor. Results will be available in the Actor's dataset for download.

Input Configuration

Provide a JSON object with these fields:

{
  "tag": "candle",
  "size": 10
}

• tag (Required): The TikTok hashtag to search for (e.g., "candle").
• size (Required): The number of videos to retrieve. Default is 10.

Output Data

The Actor outputs an array of objects. Each object contains the following video details:

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

Key Output Fields:
* id, url, createTime, desc: Core video identifiers and description.
* autor & authorStats: Profile details and statistics for the video creator.
* challenges: Associated hashtag challenges.
* music: Track information used in the video.
* stats: Video engagement metrics (plays, likes, comments, shares).
* video: Technical details and direct URL to the video file.

Notes

• The Actor scrapes TikTok's public web interface.
• Use valid, existing TikTok tags for the tag input.
• Performance may be affected by TikTok's rate limits or anti-scraping measures.