Skip to content

Structured TikTok data: send usernames. Cursor-paginated, 1 credit per successful call.

GET Β· POST1 credit / successful callCursor-paginated
GEThttps://api.scrapier.io/api/v2/tiktok-profile-video/Open in Playground

Call GET /api/v2/tiktok-profile-video/ with usernames. The results are in data.videos; send data.next_cursor back as cursor to get the next page. 9 optional parameters refine the call (see Parameters).

Terminal window
curl -G "https://api.scrapier.io/api/v2/tiktok-profile-video/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "usernames=mrbeast" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyesβ€”Your API key from the dashboard.
usernamesstringyese.g. mrbeastTikTok handle (mrbeast / @mrbeast), profile URL or numeric user_id. Page 1 = the profile's newest videos (embed window, pinned first, <= 13); later pages walk the creator's playlists with TikTok's own playlist / item_list cursors (~15-20 per page). Rows under videos, each with the flat summary + post / computed / aweme blocks; the envelope (request, author, pagination, meta) is at the top level. Each call is bounded (~60 s budget): a slow upstream returns partial rows + next_cursor + warning. next_cursor is null once the guest-reachable pool (embed window + playlists) is exhausted. Required first call; ignored when cursor is supplied.
user_idstringnoβ€”Numeric TikTok user id (resolved via /share/user/{id}); wins over a handle, which is cross-checked.
cursorstringnoβ€”Pagination cursor returned in the previous response's next_cursor. Pass it back unchanged to fetch the next page. When next_cursor is null, you have reached the last page.
max_cursorstringnoβ€”Optional filter: ms unix time -> only videos created strictly before it are returned (applied to every page).
locked in cursor
sort_bystringnolatestCompatibility only (no reorder; sort_applied false).
latestpopular
locked in cursor
trimbooleannofalseCompatibility flag, echoed in request.
locked in cursor
complete_schemabooleannotruetrue = full native mobile-API aweme schema (~184 keys); false = web-exposed fields only.
locked in cursor
discovery_limitintegerno200000Max playlist videos walked over the whole cursor chain; 0 = embed window only (newest 13, one page).
locked in cursor
enrichstringnoautoauto = open the video pages (likes / comments / music / hashtags) of the first 3 page-1 (embed) videos only, the rest carry embed data (views, caption, cover, play URL); true = every page-1 video and also every playlist video; false = never (page 1 then carries embed data only: views, caption, cover, play URL).
autotruefalse
locked in cursor
regionstringnoUS2-letter country code (priority_region / viewer_region; {region} proxy placeholder only if the platform proxy URL has one).
locked in cursor
Advanced
NameTypeDefaultDescription
use_proxybooleantrueRoute the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise.
raw_databooleanfalseWhen true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under raw_responses, in place of the formatted items. When false (default) you get the formatted output. Pagination (cursor / next_cursor) works the same in both modes.
{
"success": true,
"data": {
"usernames": "mrbeast",
"user_id": "6614519312189947909",
"username": "mrbeast",
"page": 1,
"page_size": 10,
"status": "ok",
"error": null,
"status_code": 0,
"status_msg": "",
"platform": "tiktok",
"request": {
"handle": "mrbeast",
"handle_input": "mrbeast",
"user_id": "6614519312189947909",
"user_id_input": null,
"sort_by": "latest",
"sort_applied": false,
"max_cursor": null,
"max_cursor_input": null,
"region": "US",
"trim": false,
"count": 15,
"enrich": "auto",
"discovery_limit": 200000,
"complete_schema": true
},
"author": {
"uid": "6614519312189947909",
"sec_uid": "MS4wLjABAAAABKjQkOz_IIzXXzEAl_9LGsWhvK-gBnlczwRPXK8EmxAp6K3X0qiaP5_OEqmm0XwG",
"unique_id": "mrbeast",
"nickname": "MrBeast",
"signature": "Checkout My New Book!πŸ‘‡",
"avatar_thumb": {
"uri": "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/1e2348ca19d3...",
"url_list": [
"..."
],
"width": 100,
"height": 100
},
"avatar_medium": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/1e2348ca19d3...",
"url_list": [
"..."
],
"width": 720,
"height": 720
},
"avatar_larger": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/1e2348ca19d3...",
"url_list": [
"..."
],
"width": 1080,
"height": 1080
},
"verified": true,
"custom_verify": "Verified account",
"verification_type": 1,
"private_account": false,
"secret": false,
"follower_count": 141097104,
"following_count": 355,
"aweme_count": 474,
"total_favorited": 1472750393,
"favoriting_count": 0,
"friend_count": 285,
"create_time": 1540063576,
"language": "en",
"region": null,
"bio_link": "http://themostdangerousgames.com",
"bio_link_risk": 3,
"is_commerce_user": false,
"category": null,
"tt_seller": false,
"is_organization": 0,
"is_ad_virtual": false,
"is_embed_banned": false,
"open_favorite": false,
"comment_setting": 0,
"duet_setting": 0,
"stitch_setting": 0,
"download_setting": 0,
"following_visibility": 2,
"profile_tab": {
"showMusicTab": true,
"showQuestionTab": false,
"showPlayListTab": true
},
"room_id": null,
"unique_id_modify_time": 0,
"nickname_modify_time": 1651262162,
"profile_url": "https://www.tiktok.com/@mrbeast",
"viewer_region": "US"
},
"max_cursor": null,
"min_cursor": 1789755236000,
"has_more": true,
"aweme_count": 10,
"total": 474,
"reachable_videos": null,
"pagination": {
"mode": "embed_window",
"has_more": true,
"returned": 10,
"playlist_cursor": 0,
"playlist_index": 0,
"mix_offset": 0,
"playlist_videos_walked": 0
},
"meta": {
"fetched_at": "2026-09-19T10:23:44.837Z",
"duration_ms": 3161,
"requests": 13,
"retries": 0,
"waf_solved": 1,
"akamai_denied": 0,
"sources": [
"video_page_desktop"
],
"warnings": [
"aweme fields TikTok's web layer does not expose, left as native-schema defaults: suggest_words, visual_search_info, smart_search_info, music.matched_song (need the mobile app API / a registered device)"
]
},
"note": null,
"warnings": [
"aweme fields TikTok's web layer does not expose, left as native-schema defaults: suggest_words, visual_search_info, smart_search_info, music.matched_song (need the mobile app API / a registered device)"
],
"warning": null,
"next_cursor": "eyJkdiI6MCwiZSI6WyI3NjkxNTA5NjI3MzAzNTI4MzM5IiwiNzY5MTI1ODk2...",
"videos": [
{
"input_username": "mrbeast",
"input_user_id": null,
"username": "mrbeast",
"user_id": "6614519312189947909",
"status": "ok",
"error": null,
"video_id": "7686940133609786655",
"url": "https://www.tiktok.com/@mrbeast/video/7686940133609786655",
"description": "we nailed it @Erling Haaland ",
"created_at": "2026-09-18T18:13:56.000Z",
"create_time": 1789755236,
"play_count": 29200000,
"like_count": 6900000,
"comment_count": 96300,
"share_count": 903900,
"save_count": 388068,
"repost_count": 0,
"duration_seconds": 7,
"thumbnail_url": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/owfiA82FX...",
"play_url": "https://v45.tiktokcdn.com/285b308affeddcd15a9ec3d1aef15270/6ab105b6/vi...",
"download_url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c79...",
"pinned": false,
"is_photo_post": false,
"hashtags": [],
"mentions": [
"erling"
],
"music_title": "original sound",
"music_author": "πŸ¦“",
"location_created": "GB",
"text_language": "en",
"playlists": [],
"source": "video_page_desktop",
"post": {
"id": "7686940133609786655",
"url": "https://www.tiktok.com/@mrbeast/video/7686940133609786655",
"content": {
"text": "we nailed it @Erling Haaland ",
"media_urls": "https://v45.tiktokcdn.com/285b308affeddcd15a9ec3d1aef15270/6ab105b6/vi...",
"media_url_list": [
"https://v45.tiktokcdn.com/285b308affeddcd15a9ec3d1aef15270/6ab105b6/vi...",
"..."
],
"download_url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c79...",
"thumbnail_url": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/owfiA82FX...",
"origin_cover_url": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/o4INE8KfM...",
"dynamic_cover_url": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/owfiA82FX...",
"duration_seconds": 7,
"width": 576,
"height": 1024,
"ratio": "540p",
"format": "mp4",
"codec": "h264",
"bitrate": 997732,
"size_bytes": 949717,
"hashtags": [],
"mentions": [
"erling"
],
"is_photo_post": false,
"image_urls": []
},
"author": {
"id": "6614519312189947909",
"username": "mrbeast",
"display_name": "MrBeast",
"avatar_url": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/1e2348ca19d3...",
"verified": true,
"signature": "Checkout My New Book!πŸ‘‡",
"sec_uid": "MS4wLjABAAAABKjQkOz_IIzXXzEAl_9LGsWhvK-gBnlczwRPXK8EmxAp6K3X0qiaP5_OEqmm0XwG",
"url": "https://www.tiktok.com/@mrbeast"
},
"engagement": {
"views": 29200000,
"likes": 6900000,
"comments": 96300,
"shares": 903900,
"saves": 388068,
"reposts": 0
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": false,
"deleted": false,
"private": false,
"ad": false,
"ad_authorization": false,
"aigc": false,
"aigc_label_shown": true,
"original_item": false,
"official_item": false,
"for_friend": false,
"duet_enabled": true,
"stitch_enabled": true,
"share_enabled": true,
"comments_enabled": true,
"index_enabled": true,
"is_reviewing": false,
"is_prohibited": false,
"warn_info": []
},
"published_at": "2026-09-18T18:13:56.000Z",
"ext": {
"music_id": "7672649840236464926",
"music_title": "original sound",
"music_author": "πŸ¦“",
"music_original": true,
"author_id": "6614519312189947909",
"author_followers": 141097105,
"author_video_count": 474,
"author_total_likes": 1472750818,
"download_count": null,
"published_at_epoch": 1789755236,
"location_created": "GB",
"location_created_name": "United Kingdom",
"viewer_region": "US",
"text_language": "en",
"playlist_id": null,
"playlist_name": null,
"playlists": [],
"category_type": 112,
"diversification_labels": [
"Traditional Sports",
"Sports",
"Sport & Outdoor"
],
"schedule_time": null,
"subtitle_languages": [],
"vq_score": "63.96",
"source": "video_page_desktop"
}
},
"computed": {
"engagement_rate": 0.270555,
"engagement_rate_pct": 27.0555,
"like_rate": 0.236301,
"comment_rate": 0.003298,
"share_rate": 0.030955,
"save_rate": 0.01329,
"total_interactions": 8288268,
"language": "en",
"content_category": "traditional sports",
"estimated_reach": 35040000,
"age_days": 0.67,
"views_per_day": 29200000,
"hashtag_count": 0,
"mention_count": 1,
"caption_length": 29,
"is_short": true
},
"aweme": {
"aweme_id": "7686940133609786655",
"desc": "we nailed it @Erling Haaland ",
"desc_language": "en",
"region": "GB",
"region_name": "United Kingdom",
"create_time": 1789755236,
"create_time_utc": "2026-09-18T18:13:56.000Z",
"url": "https://www.tiktok.com/@mrbeast/video/7686940133609786655",
"aweme_type": 0,
"content_type": "video",
"author_user_id": 6614519312189948000,
"is_top": 0,
"is_ad": false,
"is_paid_partnership": false,
"statistics": {
"aweme_id": "7686940133609786655",
"comment_count": 96300,
"digg_count": 6900000,
"download_count": 0,
"play_count": 29200000,
"share_count": 903900,
"forward_count": 0,
"lose_count": 0,
"lose_comment_count": 0,
"whatsapp_share_count": 0,
"collect_count": 388068,
"repost_count": 0
},
"author": {
"uid": "6614519312189947909",
"unique_id": "mrbeast",
"nickname": "MrBeast",
"sec_uid": "MS4wLjABAAAABKjQkOz_IIzXXzEAl_9LGsWhvK-gBnlczwRPXK8EmxAp6K3X0qiaP5_OEqmm0XwG",
"follower_count": 141097105,
"aweme_count": 474,
"total_favorited": 1472750818,
"verification_type": 1
},
"music": {
"id_str": "7672649840236464926",
"title": "original sound",
"author": "πŸ¦“",
"duration": 7,
"is_original": true
},
"video": {
"play_addr": {
"uri": "v15044gf0000damnu1nog65t5hvkv5cg",
"url_list": [
"https://v45.tiktokcdn.com/285b308affeddcd15a9ec3d1aef15270/6ab105b6/vi..."
],
"width": 576,
"height": 1024
},
"cover": {
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/owfiA82FX..."
]
},
"duration": 7000,
"ratio": "540p",
"bit_rate": [
{
"gear_name": "normal_540_0",
"bit_rate": 997732,
"codec_type": "h264"
},
{
"gear_name": "adapt_lower_720_1",
"bit_rate": 465428,
"codec_type": "h265_hvc1"
},
"..."
]
},
"status": {
"aweme_id": "7686940133609786655",
"is_delete": false,
"allow_share": true,
"allow_comment": true,
"private_status": 0,
"in_reviewing": false,
"reviewed": 0,
"self_see": false,
"is_prohibited": false,
"download_status": 0,
"review_result": {
"review_status": 102
},
"violation_display_status": 0,
"take_down": 0
},
"video_control": {
"allow_download": true,
"share_type": 0,
"show_progress_bar": 0,
"draft_progress_bar": 0,
"allow_duet": true,
"allow_react": true,
"prevent_download_type": 0,
"allow_dynamic_wallpaper": true,
"timer_status": 0,
"allow_music": true,
"allow_stitch": true
},
"aweme_acl": {
"download_general": {
"code": 0,
"show_type": 2,
"transcode": 1,
"mute": false,
"extra": "101"
},
"download_mask_panel": {
"code": 0,
"show_type": 2,
"transcode": 1,
"mute": false,
"extra": "101"
},
"share_list_status": 0,
"share_general": {
"code": 0,
"show_type": 2,
"transcode": 1,
"mute": false,
"extra": "101",
"toast_msg": ""
},
"platform_list": null,
"share_action_list": null,
"press_action_list": null
},
"...": "+163 more native-schema keys (text_extra, cha_list, share_info, interact_permission, playlist_info, aigc_info, comment_config, content_model, poi_data, ...)"
},
"status_code": 0,
"status_msg": "",
"platform": "tiktok",
"request": {
"handle": "mrbeast",
"handle_input": "mrbeast",
"user_id": "6614519312189947909",
"user_id_input": null,
"sort_by": "latest",
"sort_applied": false,
"max_cursor": null,
"max_cursor_input": null,
"region": "US",
"trim": false,
"count": 15,
"enrich": "auto",
"discovery_limit": 200000,
"complete_schema": true
},
"author": {
"uid": "6614519312189947909",
"sec_uid": "MS4wLjABAAAABKjQkOz_IIzXXzEAl_9LGsWhvK-gBnlczwRPXK8EmxAp6K3X0qiaP5_OEqmm0XwG",
"unique_id": "mrbeast",
"nickname": "MrBeast",
"signature": "Checkout My New Book!πŸ‘‡",
"avatar_thumb": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/1e2348ca19d3...",
"url_list": [
"..."
],
"width": 100,
"height": 100
},
"avatar_medium": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/1e2348ca19d3...",
"url_list": [
"..."
],
"width": 720,
"height": 720
},
"avatar_larger": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/1e2348ca19d3...",
"url_list": [
"..."
],
"width": 1080,
"height": 1080
},
"verified": true,
"custom_verify": "Verified account",
"verification_type": 1,
"private_account": false,
"secret": false,
"follower_count": 141097105,
"following_count": 355,
"aweme_count": 474,
"total_favorited": 1472750818,
"favoriting_count": 0,
"friend_count": 285,
"create_time": 1540063576,
"language": "en",
"region": null,
"bio_link": "http://themostdangerousgames.com",
"bio_link_risk": 3,
"is_commerce_user": false,
"category": null,
"tt_seller": false,
"is_organization": 0,
"is_ad_virtual": false,
"is_embed_banned": false,
"open_favorite": false,
"comment_setting": 0,
"duet_setting": 0,
"stitch_setting": 0,
"download_setting": 0,
"following_visibility": 2,
"profile_tab": {
"showMusicTab": true,
"showQuestionTab": false,
"showPlayListTab": true
},
"room_id": null,
"unique_id_modify_time": 0,
"nickname_modify_time": 1651262162,
"profile_url": "https://www.tiktok.com/@mrbeast",
"viewer_region": "US"
},
"next_cursor": null,
"max_cursor": null,
"min_cursor": 1789755236000,
"has_more": true,
"aweme_count": 10,
"total": 474,
"reachable_videos": null,
"pagination": {
"mode": "embed_window",
"has_more": true,
"returned": 10,
"playlist_cursor": 0,
"playlist_index": 0,
"mix_offset": 0,
"playlist_videos_walked": 0
},
"meta": {
"fetched_at": "2026-09-19T10:23:44.837Z",
"duration_ms": 3161,
"requests": 13,
"retries": 0,
"waf_solved": 1,
"akamai_denied": 0,
"sources": [
"video_page_desktop"
],
"warnings": [
"aweme fields TikTok's web layer does not expose, left as native-schema defaults: suggest_words, visual_search_info, smart_search_info, music.matched_song (need the mobile app API / a registered device)"
]
},
"note": null,
"warnings": [
"aweme fields TikTok's web layer does not expose, left as native-schema defaults: suggest_words, visual_search_info, smart_search_info, music.matched_song (need the mobile app API / a registered device)"
],
"position": 1,
"scraped_at": "2026-09-19T10:23:44.837Z"
},
"... 9 more rows in the same shape"
]
}
}

Sample from the live catalog; arrays trimmed to 3 items. Results are in data.videos.

FieldTypeExampleDescription
usernamesstringmrbeastβ€”
user_idstring6614519312189947909β€”
usernamestringmrbeastβ€”
pageinteger1β€”
page_sizeinteger10β€”
statusstringokβ€”
errornullnullβ€”
status_codeinteger0β€”
status_msgstringβ€”
platformstringtiktokβ€”
requestobject{…}β€”
authorobject{…}β€”
max_cursornullnullβ€”
min_cursorinteger1789755236000β€”
has_morebooleantrueβ€”
aweme_countinteger10β€”
totalinteger474β€”
reachable_videosnullnullβ€”
paginationobject{…}β€”
metaobject{…}β€”
notenullnullβ€”
warningsarray[1 item]β€”
warningnullnullβ€”
next_cursorstringeyJkdiI6MCwiZSI6WyI3NjkxNTA5NjI3MzAzNTI4MzM5I…Pass back as cursor for the next page. null on the last page.
videosarray[2 items]The results.
videos[].input_usernamestringmrbeastβ€”
videos[].input_user_idnullnullβ€”
videos[].usernamestringmrbeastβ€”
videos[].user_idstring6614519312189947909β€”
videos[].statusstringokβ€”
videos[].errornullnullβ€”
videos[].video_idstring7686940133609786655β€”
videos[].urlstringhttps://www.tiktok.com/@mrbeast/video/7686940…—
videos[].descriptionstringwe nailed it @Erling Haaland β€”
videos[].created_atstring2026-09-18T18:13:56.000Zβ€”
videos[].create_timeinteger1789755236β€”
videos[].play_countinteger29200000β€”
videos[].like_countinteger6900000β€”
videos[].comment_countinteger96300β€”
videos[].share_countinteger903900β€”
videos[].save_countinteger388068β€”
videos[].repost_countinteger0β€”
videos[].duration_secondsinteger7β€”
videos[].thumbnail_urlstringhttps://p16-common-sign.tiktokcdn.com/tos-use…—
videos[].play_urlstringhttps://v45.tiktokcdn.com/285b308affeddcd15a9…—
videos[].download_urlstringhttps://v16-webapp-prime.tiktok.com/video/tos…—
videos[].pinnedbooleanfalseβ€”
videos[].is_photo_postbooleanfalseβ€”
videos[].hashtagsarray[]β€”
videos[].mentionsarray[1 item]β€”
videos[].music_titlestringoriginal soundβ€”
videos[].music_authorstringπŸ¦“β€”
videos[].location_createdstringGBβ€”
videos[].text_languagestringenβ€”
videos[].playlistsarray[]β€”
videos[].sourcestringvideo_page_desktopβ€”
videos[].postobject{…}β€”
videos[].computedobject{…}β€”
videos[].awemeobject{…}β€”
videos[].status_codeinteger0β€”
videos[].status_msgstringβ€”
videos[].platformstringtiktokβ€”
videos[].requestobject{…}β€”
videos[].authorobject{…}β€”
videos[].next_cursornullnullβ€”
videos[].max_cursornullnullβ€”
videos[].min_cursorinteger1789755236000β€”
videos[].has_morebooleantrueβ€”
videos[].aweme_countinteger10β€”
videos[].totalinteger474β€”
videos[].reachable_videosnullnullβ€”
videos[].paginationobject{…}β€”
videos[].metaobject{…}β€”
videos[].notenullnullβ€”
videos[].warningsarray[1 item]β€”
videos[].positioninteger1β€”
videos[].scraped_atstring2026-09-19T10:23:44.837Zβ€”

Pass data.next_cursor back as cursor until it is null. Required inputs are ignored once a cursor is sent. Each page is one billed call. More in Pagination.

const url = "https://api.scrapier.io/api/v2/tiktok-profile-video/";
let params = { usernames: "mrbeast" };
const items = [];
for (let page = 0; page < 10; page++) { // each page is one billed call
const res = await fetch(`${url}?${new URLSearchParams(params)}`, {
headers: { "X-API-Key": "YOUR_API_KEY" },
signal: AbortSignal.timeout(210_000),
});
const body = await res.json();
if (!res.ok) throw new Error(body.error ?? body.detail ?? `HTTP ${res.status}`);
const data = body.data;
items.push(...(data.videos ?? []));
if (!data.next_cursor) break; // null = last page
params = { cursor: data.next_cursor };
}

Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.

StatusMeaningRetry?Charged?
400Bad or missing input.No β€” fix the paramsNo
401 / 403Missing, invalid or revoked API key.No β€” fix the keyNo
402Out of credits (body has balance).No β€” top upNo
404Unknown endpoint slug.No β€” check the slugNo
429 / 503Busy or throttled.Yes β€” after Retry-AfterNo
5xxTarget site or upstream failure, or timeout.Yes β€” with backoffNo
  • Locked into the cursor: max_cursor, sort_by, trim, complete_schema, discovery_limit, enrich, region. Set them on the first call; later pages reuse them.
  • TikTok Ad Library Leads β€” Structured TikTok data: every input is optional. Single lookup, 3 credits per successful call.
  • TikTok Ad Library β€” Structured TikTok data: send urls. Cursor-paginated, 1 credit per successful call.
  • TikTok Ads Top β€” Structured TikTok data: every input is optional. Cursor-paginated, 1 credit per successful call.
  • TikTok Collection Videos β€” Structured TikTok data: send urls. Cursor-paginated, 1 credit per successful call.