List TikTok profile videos
Lists videos for a TikTok profile with cursor-based pagination. Optional query `sortBy` is `latest` or `popular`; when omitted, a default ordering applies—pass `sortBy` explicitly if you need predictable ordering. This route does not expose `lookupStatus`; an empty `data.videos` array can occur for several reasons—call `GET /v1/tiktok/profiles/{handle}` first when you need explicit `found` / `private` / `not_found` before interpreting an empty list.
Operation
/v1/tiktok/profiles/{handle}/videosHeaders
API key (`sfk_...`)
Parameters
TikTok handle whose videos should be listed.
min 1 chars · max 64 chars
Optional sort order for the returned TikTok videos.
one of: latest, popular
Pagination cursor returned by a previous response.
min 1 chars
Optional TikTok user id to speed up the request.
min 1 chars
Optional region (country code) for the request.
min 1 chars
Optional flag for a smaller response with fewer fields.
Response fields
Endpoint-specific response payload.
TikTok videos for the requested profile page. An empty array can mean no videos in the selected sort window, a private profile, or other cases—this route has no `lookupStatus`; use the profile endpoint when you need explicit outcomes.
TikTok video identifier.
min 1 chars
Caption text shown for the TikTok video.
ISO-8601 timestamp when the video was created, when available.
Canonical public TikTok URL for the video.
Best available thumbnail or cover image URL for the video.
Video duration in milliseconds, when available.
≥ 0
Whether the video is pinned on the profile.
Whether TikTok marks the video as an ad.
Engagement metrics for the video.
View count reported by TikTok for the video.
≥ 0
Like count reported by TikTok for the video.
≥ 0
Comment count reported by TikTok for the video.
≥ 0
Share count reported by TikTok for the video.
≥ 0
Save or collection count reported by TikTok for the video.
≥ 0
Download-related media URLs for the video.
Best available downloadable video URL, usually with watermark.
Best available downloadable video URL without watermark.
Additional TikTok-native fields for this video (for example author, music, challenges, and full `video` and `statistics` objects). Keys that only duplicate the top-level fields are omitted.
Pagination state for the current response.
Cursor to pass in the next request when more videos are available.
Whether another page of videos is available.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
TikTok videos for the requested profile.
Error codes