> Documentation index: https://docs.scrapier.io/llms.txt
> Auth: header `X-API-Key: <key>` · Base: https://api.scrapier.io/api/v2 · Synchronous; paginate with `cursor` ← `data.next_cursor`.

# TikTok Profile Video

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

`GET|POST https://api.scrapier.io/api/v2/tiktok-profile-video/` · 1 credit per successful call · Cursor-paginated

## 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

```bash
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
```

```python
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"])
```

POST with a JSON body works too (same parameters; the body is merged over the query string).

## Parameters

| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| `X-API-Key` (header) | string | yes | — | Your API key. |
| `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). One of: `latest`, `popular`. 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). One of: `auto`, `true`, `false`. 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. |
| `use_proxy` | boolean | no | `true` | Route the request through Scrapier's residential proxy pool. Default: `true`. Leave as is unless support tells you otherwise. |
| `raw_data` | boolean | no | `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

HTTP 200. Results are in `data.videos`. Sample from the live catalog, arrays trimmed to 3 items.

```json
{
  "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"
    ]
  }
}
```

## 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

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.

```python
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"]}
```

## Errors

Failed calls are free. Branch on HTTP status; the message is in `error` (or `detail`). See https://docs.scrapier.io/errors.md

- **400** Bad input. The exact message varies by endpoint. `{"success":false,"error":"…"}`
- **402** Balance below the endpoint's price. `{"error":"Insufficient credits. Buy more to scrape more.","balance":1,"required":2}`
- **403** Invalid or unknown API key. `{"detail":"Authentication service unavailable or invalid API key."}`
- **429** Throttled — wait for Retry-After. `{"detail":"Request was throttled. Expected available in N seconds."}`
- **404** unknown slug · **503** busy (retry after `Retry-After`) · **5xx** upstream failure or timeout (retry with backoff).

## Notes

- 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

- [TikTok Ad Library Leads](https://docs.scrapier.io/api-reference/tiktok/tiktok-ad-library-leads.md): Structured TikTok data: every input is optional. Single lookup, 3 credits per successful call.
- [TikTok Ad Library](https://docs.scrapier.io/api-reference/tiktok/tiktok-ads.md): Structured TikTok data: send `urls`. Cursor-paginated, 1 credit per successful call.
- [TikTok Ads Top](https://docs.scrapier.io/api-reference/tiktok/tiktok-ads-top.md): Structured TikTok data: every input is optional. Cursor-paginated, 1 credit per successful call.
- [TikTok Collection Videos](https://docs.scrapier.io/api-reference/tiktok/tiktok-collection-videos.md): Structured TikTok data: send `urls`. Cursor-paginated, 1 credit per successful call.
