TikTok Videos by Profile Scraper

This Apify Actor scrapes video data from a specified TikTok user profile. It extracts detailed metadata for each video, including stats, author info, and associated music or challenges.

Key Features

• Scrapes videos from any public TikTok profile using the username.
• Returns structured data for each video, such as descriptions, engagement statistics, and media details.
• Allows control over the number of videos to retrieve.
• Outputs data in a consistent JSON format suitable for analysis or integration.

How to Use

1. Deploy the Actor on the Apify platform.
2. Configure the run by providing the required input parameters (see below).
3. Run the Actor. It will fetch the data from TikTok's public web interface.
4. Retrieve the results from the Actor's output dataset.

Input Configuration

Provide a JSON object with the following parameters:

{
  "profile": "nike",
  "size": 10
}

• profile (Required): The TikTok username to scrape (e.g., "nike").
• size (Required): The number of videos to retrieve. The default is 10.

Output Data

The Actor returns an array of objects. Each object contains the complete details for one video. The structure is as follows:

{
  "id": "123456789",
  "url": "https://www.tiktok.com/@example_user/video/123456789",
  "createTime": 1680000000,
  "desc": "Video description text.",
  "autor": {
    "id": "987654321",
    "avatarLarger": "https://example.com/avatar_large.jpg",
    "avatarMedium": "https://example.com/avatar_medium.jpg",
    "avatarThumb": "https://example.com/avatar_thumb.jpg",
    "nickname": "Example User",
    "uniqueId": "example_user",
    "verified": true,
    "privateAccount": false
  },
  "authorStats": {
    "followerCount": 1000,
    "heartCount": 5000,
    "videoCount": 50
  },
  "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 Output Fields:
* id, url, createTime, desc: Core video identifiers and metadata.
* autor & authorStats: Profile details and channel statistics.
* challenges: Any hashtag challenges associated with the video.
* music: Track information used in the video.
* stats: Video engagement metrics (plays, likes, comments, shares).
* video: Technical details and a direct URL to the video file.

Notes

• The Actor scrapes TikTok's public website. Ensure the target profile is a valid, existing username.
• Performance may be affected by TikTok's rate limits or anti-scraping measures.
• Use the size parameter to manage the scope of your data collection.