TikTok

Fetches 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.

get/v3/tiktok/profile/videos

Request

  • Base URL
    https://api.scrapecreators.com
  • URL
    https://api.scrapecreators.com/v3/tiktok/profile/videos
  • Auth
    API key in header x-api-key

Query parameters

handlestring required

TikTok handle

user_idstring

TikTok user id. Use this for faster responses.

sort_by'latest' | 'popular'

What to sort by

regionstring

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.

include_pinnedboolean

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.

trimboolean

Set to true for a trimmed down version of the response

max_cursorstring

Cursor to get more videos. Get 'max_cursor' from previous response.

Response

Successful response

Changes