Description
This endpoint allows you to fetch a paginated list of videos from a specified TikTok user’s profile. It returns comprehensive video metadata including statistics, timestamps, and pagination support for accessing more videos.Endpoint
POST/api/v1/get-tiktok-profile-videos
Request Headers
| Header | Type | Description |
|---|---|---|
Content-Type | string | Must be application/json. |
Authorization | string | Your API key (Bearer token). e.g. Bearer sk_xxx |
Request Body
| Parameter | Type | Description | Required | Default |
|---|---|---|---|---|
handle | string | The TikTok user handle (username). | Yes | |
maxCursor | string | Optional cursor for pagination. Pass the max_cursor from a previous response to get the next page. | No | |
trim | boolean | Whether to get a trimmed/simplified response. | No | false |
requestSource | string | Optional. Source of the request (e.g., MAKE_DOT_COM, ZAPIER, API). | No | API |
The
handle is the username you see on TikTok, like stoolpresidente. Do not include the @ symbol.Responses
Success (200 OK)
Returns a JSON object containing an array of videos and pagination information.Content-Type: application/json
- X-RateLimit-Limit: The rate limit for the user.
- X-RateLimit-Remaining: The remaining number of requests for the user.
Error Responses
400 Bad Request
Indicates an issue with the request parameters.Invalid JSON in request body'handle' parameter is required and must be a non-empty string.The video service could not process the handle.The video service reported an issue.
401 Unauthorized
API key is missing, invalid, or inactive.403 Forbidden
API key does not have enough credits.404 Not Found
The requested TikTok profile could not be found.500 Internal Server Error
An unexpected error occurred on the server.Service not configured. Please contact support.Service authentication failed. Please contact support.An unexpected server error occurred...
502 Bad Gateway
Indicates an issue with an upstream service.The video service is currently unavailable.Received invalid data format from video service.Error fetching video data from the upstream service.
503 Service Unavailable
Rate limit exceeded with an upstream service.Example Request
cURL
Node.js (fetch)
Notes
- Use the
max_cursorfield from the response to paginate through all videos. - The
has_morefield indicates whether there are additional pages available (1 = yes, 0 = no). - Video statistics include view counts, likes (digg_count), comments, shares, and downloads.
Credit Cost
This endpoint costs 1 credit per successful request. For more details, see our Credit Costs page.Rate Limiting
This endpoint is subject to standard API rate limits. Check theX-RateLimit-Limit and X-RateLimit-Remaining headers in the response to monitor your usage.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Cursor for pagination.
When true, returns a simplified payload.
Optional identifier describing where the API request originated.
Available options:
API, WEB, MAKE_DOT_COM, ZAPIER, N8N, PLAYGROUND, DEFAULT_AUTOMATION, AGENT_PREVIEW, AGENT_LIVE, AUTOPILOT, STUDIO