TikTok Video Scraper

Extract public TikTok video metadata from video URLs. No TikTok account or login is required for video data. Results are structured JSON, exportable to CSV, Excel, or an API.

Comments: TikTok gates comments behind login on the web, so a logged-out run returns the video record and a status row rather than comments. Comment collection needs a logged-in session and is off by default. See Limitations.

What you get

For each video:

• Caption, author (handle, nickname, verified), create time (ISO)
• Play, like, comment, share, save, and repost counts (exact numbers)
• Duration, cover image, sound name and author, hashtags, mentions
• Location, slideshow flag, ad flag, AI-generated flag

For each comment (when comments per video is above 0):

• Comment text, author handle and nickname, create time (ISO)
• Like count, reply count, pinned-by-author and liked-by-author flags
• Replies attached as their own rows with parentCommentId

Usage

1. Add video URLs to TikTok video URLs (one per line).
2. Set Comments per video to how many comments you want from each video. Leave it at 0 for the video record only.
3. Set Replies per comment if you also want replies.
4. Run the Actor. Output is one video row per URL, followed by comment and reply rows.

Minimal input:

{
    "postURLs": ["https://www.tiktok.com/@billieeilish/video/7050551461734042926"],
    "commentsPerPost": 50,
    "maxRepliesPerComment": 5
}

Input

Field	Type	Default	Notes
postURLs	array	required	Video URLs or numeric IDs
commentsPerPost	integer	0	Comments per video; 0 means video record only
maxRepliesPerComment	integer	0	Replies per top-level comment
maxScrolls	integer	40	Upper bound on comment paging per video
proxyCountryCode	string	None	Collect results as seen from a country

Output

One type: "video" row per URL, then type: "comment" and type: "reply" rows. A video that cannot be read returns a row with an error field (not_found, unavailable, or request_failed) instead of being dropped.

Limitations

• Comment collection is best effort. TikTok gates comments for logged-out viewers and may serve a login wall instead of the comment list. When that happens the Actor still returns the video record but zero comments. Comment yield is therefore less reliable than video metadata.
• Comment totals for very popular videos are bounded by maxScrolls. Reaching your target means the requested sample was collected, not that every comment was retrieved.
• Reply completeness is best effort. TikTok does not always expose every reply to a logged-out viewer, so some reply counts will exceed the replies returned.
• Comments on private or restricted videos are not accessible and return the video record only, or an error row.
• Fields TikTok does not expose for a given video are returned as null rather than guessed.
• Only public data is collected. This Actor does not log in or access anything behind an account.

Reliability

• No login and no account, so there is no session to expire or get flagged mid-run.
• A video that cannot be read returns an explicit error row, so a run never ends in a silent empty result.
• The Actor retries on a fresh session if TikTok shows a block, and reads the data embedded in the public video page, the most stable part of the site.

FAQ

• Do I need a TikTok account or cookies? No. This Actor collects only public video data with no login.
• Does it return comments? No. TikTok gates comments behind login on the web, so a logged-out run returns the video record and a status row, not comments.
• Can it download the video file? It returns the cover image and metadata. Media download is not enabled in this version.
• What formats can I export? JSON, CSV, Excel, and HTML through the Apify dataset, or via the API.

Legal

Use this Actor only for publicly available data and in line with TikTok's Terms of Service and applicable law. Video and author data can include personal data; if you store or redistribute it, you are the controller and are responsible for GDPR, CCPA, and similar obligations.