TikTok User Data Extractor

This Apify actor extracts public profile data from TikTok users. It's designed for developers and marketers who need structured user data for analysis, lead generation, or integration into other applications.

Overview

The actor takes a TikTok username (uniqueId) as input and returns a structured JSON object containing the available public data from that user's profile. It handles the TikTok API interactions, allowing you to focus on using the data.

Key Features

• Extracts Comprehensive Profile Data: Retrieves key user metrics and identifiers.
• Handles API Complexity: Manages requests and data parsing from TikTok's public endpoints.
• Structured JSON Output: Returns clean, predictable data for easy integration.
• Runs on Apify Platform: Leverages Apify's infrastructure for scaling and reliability.

How to Use

You can run this actor via the Apify API, scheduled runs, or integrate it into a larger workflow. The primary input is the TikTok username.

1. Set the Input: Provide the target TikTok username(s).
2. Configure (Optional): Adjust default settings like proxy usage if needed.
3. Run the Actor: Execute the actor via the Apify Console, API, or CLI.
4. Get the Output: Retrieve the results in JSON format from the actor's dataset.

Basic API Call Example

curl "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/runs?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"startUrls": [{"url": "https://www.tiktok.com/@username"}]}'

Input/Output

Input

The main input is the TikTok username, typically provided via a start URL.
* Format: https://www.tiktok.com/@[uniqueId]
* Example: https://www.tiktok.com/@tiktok

Output

The actor outputs a single JSON object per processed profile. Key fields include:

{
  "uniqueId": "tiktok",
  "nickname": "TikTok",
  "signature": "Official TikTok account bio...",
  "verified": true,
  "privateAccount": false,
  "followerCount": 12345678,
  "followingCount": 345,
  "heartCount": 987654321,
  "videoCount": 567,
  "avatarLarger": "https://p16-sign-va.tiktokcdn.com/...",
  "createTime": 1506031743,
  "id": "1234567890123456789",
  "secUid": "MS4wLjABAAAA...a_long_encrypted_string..."
}

Core Data Points Extracted:
* Identifiers: uniqueId (username), nickname, id, secUid, shortId
* Profile Info: signature (bio), avatar URLs (various sizes)
* Status: verified, privateAccount
* Metrics: followerCount, followingCount, heartCount (total likes), videoCount
* Timestamps: createTime (Unix timestamp)

Find the actor on the Apify platform: https://apify.com/your-actor-page-link?fpr=python_automation