TikTok Profile Scraper

Overview

The TikTok Profile Scraper extracts public profile metadata and statistics for TikTok accounts. Give it profile URLs or usernames and it returns one structured row per account: display name, bio, bio link, avatars, account flags, and follower / likes / video counts.

Key Features

• Profile Metadata and Stats: Username, user ID, display name, bio, bio link, avatars, account creation time, and follower / following / likes / video / friend counts.
• Exact Counts: Returns full integer counts (for example 79,731,015 followers) instead of abbreviated values like 79.7M.
• URLs or Usernames: Accepts profile URLs, video URLs (the author's profile is scraped), bare handles, and @handles. Targets are deduplicated per username.
• Account Flags: Verified, private, organization, business (commerce), and TikTok Shop seller.
• Proxy Support: Configure Apify Proxy or your own proxies. Datacenter proxies are the default; residential is available if TikTok starts blocking.
• Fast and Lightweight: Built for quick, low-cost runs without a browser.

---

Input Schema

Input Properties

1. startUrls

   • Type: array
   • Description: TikTok profile URLs to scrape. Video URLs are accepted too — the profile of the video author is scraped.
   • Example:

     [
         { "url": "https://www.tiktok.com/@therock" },
         { "url": "https://www.tiktok.com/@khaby.lame" }
     ]
     

2. usernames

   • Type: array of string
   • Description: TikTok usernames, with or without the leading @. Merged with startUrls and deduplicated.
   • Example: ["therock", "@khaby.lame"]

3. proxyConfiguration

   • Type: object
   • Description: Proxy settings for the run. Apify Proxy datacenter IPs are used by default. If TikTok starts returning challenge pages, switch to the RESIDENTIAL group.
   • Example:

     { "useApifyProxy": true }
     

At least one of startUrls or usernames must contain a valid target, otherwise the run fails with an input error.

Input Example

{
    "startUrls": [{ "url": "https://www.tiktok.com/@therock" }],
    "usernames": ["khaby.lame"],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
}

---

Output

One dataset row per requested account.

Field	Type	Description
inputUrl	string	URL or username as given in the input
profileUrl	string	Canonical profile URL
username	string	Username
id	string	User ID
secUid	string	Stable account identifier
nickname	string	Display name
bio	string	Profile bio
bioLink	string	Link in bio
avatar / avatarMedium / avatarThumb	string	Avatar URLs, largest to smallest
verified	boolean	Verified account
privateAccount	boolean	Private account
isOrganization	boolean	Organization account
commerceUser	boolean	Business account
ttSeller	boolean	TikTok Shop seller
language	string	Profile language
createdTime	integer	Account creation time (Unix timestamp, seconds)
followerCount	integer	Followers
followingCount	integer	Following
heartCount	integer	Total likes received
videoCount	integer	Public videos
diggCount	integer	Likes given by the account
friendCount	integer	Mutual follows
scrapedAt	string	When the profile was scraped

Output Example

{
    "inputUrl": "https://www.tiktok.com/@therock",
    "profileUrl": "https://www.tiktok.com/@therock",
    "username": "therock",
    "id": "6745191554350760966",
    "secUid": "MS4wLjABAAAAM3R2BtjzVT-uAtstkl2iugMzC6AtnpkojJbjiOdDDrdsTiTR75-8lyWJCY5VvDrZ",
    "nickname": "The Rock",
    "bio": "CEO of #RockTok\nLife's so much sweeter when you're not an asshole",
    "bioLink": "therock.komi.io",
    "verified": true,
    "privateAccount": false,
    "followerCount": 79731015,
    "followingCount": 0,
    "heartCount": 685537318,
    "videoCount": 567,
    "diggCount": 0,
    "friendCount": 0,
    "createdTime": 1570487607,
    "scrapedAt": "2026-09-16T13:41:02.884Z"
}

Handling of missing and blocked accounts

Inputs that yield no profile are kept out of the dataset and reported in the RUN_REPORT record in the run's key-value store, alongside a warning in the log. Each entry lists the original input, the resolved username and profileUrl, a reason (notFound, invalidInput, or requestFailed), and a human-readable message:

{
    "profilesScraped": 3,
    "skippedCount": 1,
    "skipped": [
        {
            "input": "zzz_no_such_user_98765_qa",
            "username": "zzz_no_such_user_98765_qa",
            "profileUrl": "https://www.tiktok.com/@zzz_no_such_user_98765_qa",
            "reason": "notFound",
            "message": "Account not found"
        }
    ],
    "finishedAt": "2026-09-16T15:34:45.021Z"
}

• Account does not exist or was removed: skipped as notFound.
• Input without a usable username: skipped as invalidInput. If no input yields a username, the run fails with an input error.
• Private account: scraped normally — metadata and stats are returned with privateAccount: true.
• Blocked request: automatically retried. If every retry fails, the input is skipped as requestFailed. A run where all targets were blocked fails with a clear message.

The run's status message always reports how many profiles were scraped and how many inputs were skipped.