Profile Videos
Changed onFetches videos posted by a TikTok user, sortable by latest or most popular — use this to get a creator's video feed or TikToks. Returns aweme_list, an array of video objects each containing aweme_id, desc (caption), statistics (play_count, digg_count/likes, comment_count, share_count, collect_count/saves), and video (download URLs, duration, cover image). Paginate with max_cursor from the previous response, keeping the same region and sort_by throughout a cursor chain. Known limitation: this feed is not an exhaustive inventory of a creator's public posts. TikTok's web page, single-post lookup, comments, and profile feed use different public sources and request contexts; a post may be retrievable through one and unavailable or missing through another. A missing feed item does not prove deletion, and a returned item does not guarantee browser playback in your country. Try the creator's country with a two-letter region code, restarting pagination when changing it, but country selection does not guarantee completeness. Repeated requests for the same page can also return different item sets. For campaign tracking, retain submitted post URLs/IDs and refresh them with /v2/tiktok/video rather than relying only on feed discovery. Retry a suspect page within a bounded budget and deduplicate by aweme_id; do not merge cursors from separate responses. Examples and troubleshooting. Scrapes posts from a TikTok profile. TikTok can omit individual posts even after full pagination; region selection does not guarantee complete coverage. Examples and troubleshooting.
Request
- Base URLhttps://api.scrapecreators.com
- URLhttps://api.scrapecreators.com/v3/tiktok/profile/videos
- AuthAPI key in header x-api-key
Query parameters
TikTok handle
TikTok user id. Use this for faster responses.
What to sort by
Country code passed to the profile-feed source. Defaults to US. If a profile should have videos but returns none, try another relevant two-letter country code. Changing this value does not guarantee that region-restricted posts will appear.
Whether to include pinned posts. Defaults to true. Set to false to exclude posts marked as pinned, including with trim=true. Keep this value unchanged while paginating. Filtering can produce shorter or empty pages; follow has_more and max_cursor. Successful pages still cost 1 credit, including empty results.
Set to true for a trimmed down version of the response
Cursor to get more videos. Get 'max_cursor' from previous response.
Response
Successful response
Changes
- info
added the new optional
queryrequest parameterinclude_pinned
- info