This tutorial shows how to scrape TikTok video details into CSV with the TikTok Video Details Scraper for CSV Export template. You will import the workflow, replace the sample video URL, set the export path, run a watched validation pass, and check the exported metadata before adding more public links.
Before you start
Prerequisites for scraping TikTok video details
You need UScraper installed as a local desktop app, the TikTok Video Details Scraper template, and a short list of public TikTok video URLs you are allowed to review. Start with one URL. TikTok can change what it renders by region, login state, device hints, language, traffic pattern, or page experiment, so the first run is a QA pass rather than a production scrape.
This workflow is built for metadata from known video detail pages. It is not a TikTok watermark remover, media editor, follower extractor, private content viewer, CAPTCHA bypass, or broad hashtag crawler.
Technical visibility is not the same thing as permission. Review TikTok's current terms, privacy obligations, robots signals, copyright, contracts, and local law before collecting, storing, republishing, or reselling video data.
API context
TikTok API video metadata vs a video scraper
People search for tiktok api video metadata, tiktok video metadata scraper, and scrape TikTok video by URL because the official and scraping paths solve different problems.
TikTok's API v2 is the right starting point when your app fits an approved, authenticated use case. The official List Videos endpoint returns an authorized user's public video posts, while Query Videos checks video IDs for an authorized user and returns details for those videos. TikTok's Research API is a separate application-based route for qualifying research projects.
| Approach | Best fit | Practical limitation |
|---|---|---|
| TikTok Display API | Apps that need authorized user video access after consent | Not a general CSV export for arbitrary public video URLs. |
| TikTok Research API | Approved research teams with the right eligibility and scope | Requires application approval and research-oriented tooling. |
| Python scraper | Engineering teams that want versioned code and custom storage | You maintain browser rendering, selectors, retries, and compliance review. |
| Hosted scraper tools | API jobs, cloud scheduling, normalized JSON, or larger datasets | Usually introduces metered pricing, cloud custody, and vendor lock-in. |
| UScraper template | Analyst-led exports from reviewed TikTok video URLs into CSV | Best-effort page access; validate small batches before scaling. |
Workflow
How the TikTok video details scraper works
The JSON export is the authoritative workflow definition. In plain English, the template opens each video URL, waits for the page and the video article, injects JavaScript to read available page data, writes configured columns through Structured Export, and advances the multi-URL loop.
Navigate -> Wait for Page Load -> Wait for article
-> Inject JavaScript -> Structured Export -> Loop Continue
| Workflow block | Purpose | What to check |
|---|---|---|
| Navigate | Stores one or more TikTok video URLs | Replace the sample URL with approved public video links. |
| Wait for Page Load | Gives the dynamic page time to render | Increase only after a small test shows slow loading. |
| Wait for Element | Waits for the article element | Timeouts usually mean login, blocked, removed, or changed pages. |
| Inject JavaScript | Builds window.__USCRAPER_TIKTOK_VIDEO_DETAILS__ | Inspect this step when rows are blank. |
| Structured Export | Writes the selected fields to CSV | Confirm filename, save folder, headers, and append mode. |
| Loop Continue | Moves to the next URL | Keep it after export so each processed link can produce one row. |
Because file mode is append, reruns add rows to the same CSV. For repeatable TikTok analytics work, use a dated filename or clear test rows before running the same URLs again.
Output
TikTok video metadata scraper CSV fields
There is no bundled CSV sample for this template. Use the export shape summary and the JSON workflow definition together: the summary explains extraction intent, while the JSON is the authoritative source for block configuration, selectors, file name, and save location.
tiktok-video-details-scraper.csvColumn
url
Current TikTok video URL processed by the run.
Column
poster
Structured poster signal from handle and post type.
Column
tiktoker_nikname
Creator nickname or handle when exposed.
Column
post_date
Post timestamp parsed from available page data.
Column
content
Caption or description text.
Column
hashtag
Hashtags collected from caption and tag links.
Column
like_num
Like count normalized when available.
Column
comment_num
Comment count from stats or visible controls.
Column
views_num
Play or view count when TikTok exposes it.
Column
forward_num
Share count when available.
Column
bookmark_num
Favorite, collect, or bookmark count.
Column
Region
Region or location-created signal when present.
Column
Post_type
Video for this workflow.
Column
covers_url
Cover image URL from video data or Open Graph metadata.
Column
video_duration
Duration in seconds when exposed.
Column
video_download
Download or play URL only when TikTok exposes one.
Column
video_id
Video ID parsed from the URL or page data.
Column
music_name
Sound or music title.
Column
music_author
Music author or creator name.
Column
music_URL
TikTok music URL when present.
Use video_id or url for dedupe, then validate counts against the page you watched. Blank values are not automatically errors. They can mean TikTok withheld the field, the page loaded a login or regional state, the video was unavailable, or the layout changed after the template was published.
Runbook
How to scrape TikTok video by URL
Import the workflow
Open TikTok Video Details Scraper for CSV Export, download the JSON, and import it into UScraper.
Replace the sample URL
Open Navigate and paste the public TikTok video links you are allowed to process. Keep the first validation run to one to three URLs.
Confirm the export path
Structured Export writes tiktok-video-details-scraper.csv. Change the save location to your project folder before campaign, creator, or research runs.
Run while watching
Watch the browser on the first pass. Stop if TikTok shows a login prompt, CAPTCHA, unavailable video, regional message, or unexpected consent screen.
Validate and expand
Open the CSV, compare fields against the live page, clear test rows if needed, then add more approved URLs only after the sample is clean.
Troubleshooting
Common TikTok scraping issues
Blank cells usually mean TikTok did not expose that field in the current browser session, the video is unavailable or restricted, the page was partially blocked, or the markup changed. Re-run one URL while watching the browser before editing selectors.
FAQ
TikTok video details scraper FAQ
Yes. The UScraper template opens public TikTok video URLs, reads available page and metadata fields, and exports one row per processed URL into tiktok-video-details-scraper.csv.
For related workflows, browse the UScraper template library, compare more tutorials in the UScraper blog, or start with the maintained TikTok Video Details Scraper for CSV Export template and use this article as your runbook.