TikTok Profile Videos Scraper

Overview

The TikTok Profile Videos Scraper collects public videos from TikTok profiles. Paste profile URLs or usernames and get structured rows with captions, stats, covers, author details, and music info.

Key Features

• Profile input: Accepts profile URLs, video URLs (uses the author's profile), bare usernames, and @handles.
• Video metadata and stats: Caption, create time, duration, cover, views, likes, comments, shares, and saves.
• Optional MP4 download: Store each video file in the run key-value store and link it from the dataset row.
• Author details: Username, display name, avatar, verified flag, and profile URL.
• Music details: Title, author, duration, and whether the sound is original.
• Pagination: Walks through available public videos for each profile, or stops at your max limit.
• Exact counts: Prefers precise count values when TikTok provides them.
• Proxy support: Datacenter proxies by default; switch to residential 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 (video URLs also work — videos from that author are scraped).
   • Example:

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

2. usernames

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

3. limit

   • Type: integer
   • Description: Maximum number of videos to scrape per profile. Set to 0 for no limit. Default is 50.
   • Example: 100

4. downloadVideos

   • Type: boolean
   • Description: When true, downloads each video as an MP4 into the run key-value store (videos-{videoId}.mp4) and sets downloadKey / downloadUrl on the dataset row. Default is false.
   • Example: true

5. proxyConfiguration

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

     { "useApifyProxy": true }
     

At least one of startUrls or usernames must contain a valid target.

Input Example

{
    "startUrls": [
        {
            "url": "https://www.tiktok.com/@therock?lang=en"
        }
    ],
    "usernames": [],
    "limit": 100,
    "downloadVideos": false,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
}

---

Output

One dataset row per video.

Field	Type	Description
inputUrl	string	Profile URL or username as given in the input
profileUrl	string	Canonical profile URL
username	string	Profile username
secUid	string	Stable account ID used for pagination
videoId	string	Video ID
videoUrl	string	Canonical video URL
description	string	Video caption
createTime	integer	Video creation time (Unix timestamp, seconds)
duration	integer	Video duration in seconds
cover	string	Cover image URL
playCount	integer	Views
diggCount	integer	Likes
commentCount	integer	Comments
shareCount	integer	Shares
collectCount	integer	Saves
authorId	string	Author user ID
authorUsername	string	Author username
authorNickname	string	Author display name
authorAvatar	string	Author avatar URL
authorVerified	boolean	Verified author
authorProfileUrl	string	Author profile URL
musicId	string	Music / sound ID
musicTitle	string	Music title
musicAuthorName	string	Music author / creator
musicDuration	integer	Music duration in seconds
musicOriginal	boolean	Whether this is an original sound
isPinned	boolean	Best-effort pin flag when TikTok includes it; often null. Pins are not sorted to the top
isAd	boolean	Marked as an ad by TikTok
downloadKey	string	KV store key for the MP4 when downloadVideos is enabled
downloadUrl	string	API URL of the stored MP4 (may require your Apify token to fetch if the store is private)
scrapedAt	string	When the video was scraped

Output Example

{
    "inputUrl": "https://www.tiktok.com/@therock",
    "profileUrl": "https://www.tiktok.com/@therock",
    "username": "therock",
    "secUid": "MS4wLjABAAAAM3R2BtjzVT-uAtstkl2iugMzC6AtnpkojJbjiOdDDrdsTiTR75-8lyWJCY5VvDrZ",
    "videoId": "7686600539525762318",
    "videoUrl": "https://www.tiktok.com/@therock/video/7686600539525762318",
    "description": "#1 @Papatui  BUILT FOR THE SEMESTER! ...",
    "createTime": 1789676164,
    "duration": 47,
    "cover": "https://...",
    "playCount": 36500,
    "diggCount": 2604,
    "commentCount": 130,
    "shareCount": 11,
    "collectCount": 63,
    "authorId": "6745191554350760966",
    "authorUsername": "therock",
    "authorNickname": "The Rock",
    "authorAvatar": "https://...",
    "authorVerified": true,
    "authorProfileUrl": "https://www.tiktok.com/@therock",
    "musicId": "7686600580009052941",
    "musicTitle": "original sound",
    "musicAuthorName": "The Rock",
    "musicDuration": 47,
    "musicOriginal": true,
    "isPinned": null,
    "isAd": false,
    "downloadKey": null,
    "downloadUrl": null,
    "scrapedAt": "2026-09-19T00:00:00.000Z"
}

When downloadVideos is true and the CDN fetch succeeds, downloadKey looks like videos-7686600539525762318.mp4 and downloadUrl points at that record in the run key-value store. Failed or invalid downloads leave both fields null and still keep the metadata row.

isPinned is best-effort: set to true/false only when TikTok includes the pin flag on that item; otherwise null. It is not a complete pin list, and pinned videos are not guaranteed to appear first in the results.

You can also open downloaded files from the run’s Storage → Key-value store UI. The downloadUrl is an Apify API link; fetching it outside the console usually needs your Apify API token (private run stores are not public by default).

Handling of missing and blocked inputs

Inputs that yield no videos 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 (empty, notFound, invalidInput, or requestFailed), and a human-readable message.

• Profile with no public videos / private account: skipped as empty.
• Account does not exist: skipped as notFound.
• Input without a usable username: skipped as invalidInput. If no input yields a username, the run fails with an input error.
• Blocked request: automatically retried. If every retry fails before any video is saved, the input is skipped as requestFailed. A run where all targets were blocked fails with a clear message. If some videos were already saved, the run keeps those rows and only logs a warning.

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