Description
This endpoint allows you to fetch detailed public profile information for a specified TikTok user, including user details, statistics, and a list of recent items (if available from the service).Endpoint
POST/api/v1/get-tiktok-profile
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 | |
requestSource | string | Optional. Source of the request (e.g., MAKE_DOT_COM , ZAPIER , API ). Defaults to API if not provided or if sent via header. | No | API |
The
handle
is the username you see on TikTok, like stoolpresidente
.Responses
Success (200 OK)
Returns a JSON object containing the user’s profile data.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 profile service could not process the handle.
The profile 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...
(for other internal issues)
502 Bad Gateway
Indicates an issue with an upstream service.The profile service is currently unavailable.
Received invalid data format from profile service.
Error fetching profile data from the upstream service.
503 Service Unavailable
Rate limit exceeded with an upstream service.Example Request
cURL
Node.js (fetch)
Notes
- The
itemList
in the response may vary in content and structure depending on the profile and the data provided by the upstream service. It might be empty for some profiles.
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