TikTok Profile Video
Structured TikTok data: send usernames. Cursor-paginated, 1 credit per successful call.
Overview
Section titled βOverviewβ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).
Request
Section titled βRequestβcurl -G "https://api.scrapier.io/api/v2/tiktok-profile-video/" \ -H "X-API-Key: YOUR_API_KEY" \ --data-urlencode "usernames=mrbeast" \ --max-time 210const params = new URLSearchParams({ usernames: "mrbeast" });
const res = await fetch(`https://api.scrapier.io/api/v2/tiktok-profile-video/?${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}`);
console.log(body.data.videos);import requests
resp = requests.get( "https://api.scrapier.io/api/v2/tiktok-profile-video/", headers={"X-API-Key": "YOUR_API_KEY"}, params={"usernames": "mrbeast"}, timeout=210,)body = resp.json()if not resp.ok: raise RuntimeError(body.get("error") or body.get("detail"))
print(body["data"]["videos"])curl -X POST "https://api.scrapier.io/api/v2/tiktok-profile-video/" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"usernames":"mrbeast"}' \ --max-time 210Parameters
Section titled βParametersβ| Name | Type | Required | Default | Description |
|---|---|---|---|---|
X-API-Key header | string | yes | β | Your API key from the dashboard. |
usernames | string | yes | e.g. mrbeast | TikTok 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_id | string | no | β | Numeric TikTok user id (resolved via /share/user/{id}); wins over a handle, which is cross-checked. |
cursor | string | no | β | 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_cursor | string | no | β | Optional filter: ms unix time -> only videos created strictly before it are returned (applied to every page). locked in cursor |
sort_by | string | no | latest | Compatibility only (no reorder; sort_applied false). latestpopular locked in cursor |
trim | boolean | no | false | Compatibility flag, echoed in request. locked in cursor |
complete_schema | boolean | no | true | true = full native mobile-API aweme schema (~184 keys); false = web-exposed fields only. locked in cursor |
discovery_limit | integer | no | 200000 | Max playlist videos walked over the whole cursor chain; 0 = embed window only (newest 13, one page). locked in cursor |
enrich | string | no | auto | auto = 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 |
region | string | no | US | 2-letter country code (priority_region / viewer_region; {region} proxy placeholder only if the platform proxy URL has one). locked in cursor |
Advanced
| Name | Type | Default | Description |
|---|---|---|---|
use_proxy | boolean | true | Route the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise. |
raw_data | boolean | false | When 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. |
Response
Section titled βResponseβ{ "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" ] }}Bad input. The exact message varies by endpoint.
{ "success": false, "error": "β¦"}Balance below the endpointβs price.
{ "error": "Insufficient credits. Buy more to scrape more.", "balance": 1, "required": 2}Invalid or unknown API key.
{ "detail": "Authentication service unavailable or invalid API key."}Throttled β wait for Retry-After.
{ "detail": "Request was throttled. Expected available in N seconds."}Sample from the live catalog; arrays trimmed to 3 items. Results are in data.videos.
Response fields
Section titled βResponse fieldsβ| Field | Type | Example | Description |
|---|---|---|---|
usernames | string | mrbeast | β |
user_id | string | 6614519312189947909 | β |
username | string | mrbeast | β |
page | integer | 1 | β |
page_size | integer | 10 | β |
status | string | ok | β |
error | null | null | β |
status_code | integer | 0 | β |
status_msg | string | β | |
platform | string | tiktok | β |
request | object | {β¦} | β |
author | object | {β¦} | β |
max_cursor | null | null | β |
min_cursor | integer | 1789755236000 | β |
has_more | boolean | true | β |
aweme_count | integer | 10 | β |
total | integer | 474 | β |
reachable_videos | null | null | β |
pagination | object | {β¦} | β |
meta | object | {β¦} | β |
note | null | null | β |
warnings | array | [1 item] | β |
warning | null | null | β |
next_cursor | string | eyJkdiI6MCwiZSI6WyI3NjkxNTA5NjI3MzAzNTI4MzM5I⦠| Pass back as cursor for the next page. null on the last page. |
videos | array | [2 items] | The results. |
videos[].input_username | string | mrbeast | β |
videos[].input_user_id | null | null | β |
videos[].username | string | mrbeast | β |
videos[].user_id | string | 6614519312189947909 | β |
videos[].status | string | ok | β |
videos[].error | null | null | β |
videos[].video_id | string | 7686940133609786655 | β |
videos[].url | string | https://www.tiktok.com/@mrbeast/video/7686940β¦ | β |
videos[].description | string | we nailed it @Erling Haaland | β |
videos[].created_at | string | 2026-09-18T18:13:56.000Z | β |
videos[].create_time | integer | 1789755236 | β |
videos[].play_count | integer | 29200000 | β |
videos[].like_count | integer | 6900000 | β |
videos[].comment_count | integer | 96300 | β |
videos[].share_count | integer | 903900 | β |
videos[].save_count | integer | 388068 | β |
videos[].repost_count | integer | 0 | β |
videos[].duration_seconds | integer | 7 | β |
videos[].thumbnail_url | string | https://p16-common-sign.tiktokcdn.com/tos-useβ¦ | β |
videos[].play_url | string | https://v45.tiktokcdn.com/285b308affeddcd15a9β¦ | β |
videos[].download_url | string | https://v16-webapp-prime.tiktok.com/video/tosβ¦ | β |
videos[].pinned | boolean | false | β |
videos[].is_photo_post | boolean | false | β |
videos[].hashtags | array | [] | β |
videos[].mentions | array | [1 item] | β |
videos[].music_title | string | original sound | β |
videos[].music_author | string | π¦ | β |
videos[].location_created | string | GB | β |
videos[].text_language | string | en | β |
videos[].playlists | array | [] | β |
videos[].source | string | video_page_desktop | β |
videos[].post | object | {β¦} | β |
videos[].computed | object | {β¦} | β |
videos[].aweme | object | {β¦} | β |
videos[].status_code | integer | 0 | β |
videos[].status_msg | string | β | |
videos[].platform | string | tiktok | β |
videos[].request | object | {β¦} | β |
videos[].author | object | {β¦} | β |
videos[].next_cursor | null | null | β |
videos[].max_cursor | null | null | β |
videos[].min_cursor | integer | 1789755236000 | β |
videos[].has_more | boolean | true | β |
videos[].aweme_count | integer | 10 | β |
videos[].total | integer | 474 | β |
videos[].reachable_videos | null | null | β |
videos[].pagination | object | {β¦} | β |
videos[].meta | object | {β¦} | β |
videos[].note | null | null | β |
videos[].warnings | array | [1 item] | β |
videos[].position | integer | 1 | β |
videos[].scraped_at | string | 2026-09-19T10:23:44.837Z | β |
Pagination
Section titled βPaginationβ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 };}import requests
URL = "https://api.scrapier.io/api/v2/tiktok-profile-video/"HEADERS = {"X-API-Key": "YOUR_API_KEY"}params = {"usernames": "mrbeast"}items = []
for _ in range(10): # each page is one billed call resp = requests.get(URL, headers=HEADERS, params=params, timeout=210) resp.raise_for_status() data = resp.json()["data"] items.extend(data.get("videos") or []) if not data.get("next_cursor"): # None = last page break 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.
| Status | Meaning | Retry? | Charged? |
|---|---|---|---|
400 | Bad or missing input. | No β fix the params | No |
401 / 403 | Missing, invalid or revoked API key. | No β fix the key | No |
402 | Out of credits (body has balance). | No β top up | No |
404 | Unknown endpoint slug. | No β check the slug | No |
429 / 503 | Busy or throttled. | Yes β after Retry-After | No |
5xx | Target site or upstream failure, or timeout. | Yes β with backoff | No |
- 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.
Related
Section titled βRelatedβ- 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.