Scrape a TikTok profile by URL or username
Returns structured JSON for a profile. Pass either url or username (a leading @ is accepted and stripped; the URL https://www.tiktok.com/@username is built for you). A fresh scrape usually returns in ~5-45s; if it exceeds the sync window you get a snapshot_id to fetch from /v1/result.
query Parameters
urlThe profile URL to scrape. Required unless username is provided.
usernameTikTok handle instead of a URL; a leading @ is accepted and stripped.
fieldsOptional comma-separated list of top-level fields to keep in data.
Scrape a TikTok profile by URL or username › Responses
Scraped data.
typeurlScrape a TikTok video by URL
Returns structured JSON for a video URL (tiktok.com/@user/video/...). A fresh scrape usually returns in ~5-45s; if it exceeds the sync window you get a snapshot_id to fetch from /v1/result.
query Parameters
urlThe video URL to scrape.
fieldsOptional comma-separated list of top-level fields to keep in data.
Scrape a TikTok video by URL › Responses
Scraped data.
typeurlScrape the comments of a TikTok video
Returns the comments of a video URL (tiktok.com/@user/video/...) as an array. Often exceeds the sync window and answers 202 first; the snapshot is typically ready within 1-2 minutes via /v1/result.
query Parameters
urlThe video URL whose comments to scrape.
limitMaximum number of comments to return (1-50, default 10).
fieldsOptional comma-separated list of top-level fields to keep on each comment.
Scrape the comments of a TikTok video › Responses
Scraped comments.
typeurlScrape the recent videos of a TikTok profile
Returns the recent videos of a profile as an array (discovery). Pass either url or username (a leading @ is accepted and stripped). Often exceeds the sync window and answers 202 first; the snapshot is typically ready within 1-2 minutes via /v1/result.
query Parameters
urlThe profile URL whose videos to scrape. Required unless username is provided.
usernameTikTok handle instead of a URL; a leading @ is accepted and stripped.
limitMaximum number of videos to return (1-50, default 10).
fieldsOptional comma-separated list of top-level fields to keep on each video.
Scrape the recent videos of a TikTok profile › Responses
Scraped videos.
typeurlScrape a TikTok Shop product by URL
Returns structured JSON for a TikTok Shop product URL (shop.tiktok.com/..., e.g. /us/pdp/
query Parameters
urlThe TikTok Shop product URL to scrape.
fieldsOptional comma-separated list of top-level fields to keep in data.
Scrape a TikTok Shop product by URL › Responses
Scraped product data.
typeurlFetch a pending scrape result
Retrieve the result of a scrape that exceeded the sync window, using its snapshot_id. data is an array when the snapshot holds multiple records (comments, profile posts), otherwise a single object.
query Parameters
snapshot_idFetch a pending scrape result › Responses
Result ready.
statussnapshot_id