TikTok User Videos

Give this Actor one or more public TikTok usernames and it returns each user's most recent public videos as flat JSON rows: video ID, URL, caption/title, view, like, comment and share counts, duration and posting timestamp. It uses yt-dlp over Apify residential proxies. No browser, no login, no AI.

Input

{
  "usernames": ["tiktok"],
  "maxVideos": 10
}

• usernames (required): public usernames, with or without @. Up to 20 per run.
• maxVideos: most recent videos per username, 1–100 (default 10).
• maxWorkers: usernames fetched in parallel, 1–10 (default 3).

Output

One dataset row per video:

Field	Meaning
username, rank	Input username and position in the recent-videos list (1 = newest)
videoId, url	TikTok video ID and a canonical watch URL
title	Caption text (up to 300 characters)
uploader, uploaderId	Account handle and numeric ID
viewCount, likeCount, commentCount, shareCount	Counts as TikTok reports them at fetch time
durationSec	Video length in seconds
timestamp	Posting time (Unix seconds). uploadDate is often null in listings; use timestamp, or TikTok Video Details for a full record
scrapedAt	When the row was saved (UTC)

The key-value store record SUMMARY lists every username's outcome (ok, videos, error) and the run status (success, partial_success, failed, spending_limit_reached).

Limits — read before relying on it

• Public profiles only. Private, banned or nonexistent accounts return an error in SUMMARY.outcomes and are not charged.
• TikTok sometimes refuses to resolve a profile from a given IP ("Unable to extract secondary user ID"). The Actor retries on fresh proxy sessions, but some profiles can still fail on a given run. Re-run failed usernames later.
• Results depend on yt-dlp's TikTok support. If TikTok changes its site, extraction can break until the Actor is rebuilt with a newer yt-dlp.
• If every username fails, the run ends as FAILED, with reasons in SUMMARY. If some usernames succeed, the run SUCCEEDS with partial_success.
• Only metadata. No video files, comments or follower lists.

Pricing

Pay per event: $7.88 per 1,000 videos saved (video-listed, $0.00788 each), plus Apify's standard small Actor-start event. You are charged only for video rows actually written to the dataset. Failed usernames cost nothing. The Actor respects your run's maximum charge and stops saving rows when it is reached.

Responsible use

Collect only public data, and follow TikTok's terms and the privacy laws that apply to you. Personal data such as handles can be regulated in your jurisdiction.