TikTok Creator Info API
The TikTok Creator Info API fetches TikTok creator info for a connected account so a posting flow can be built around that creator's actual settings. A single GET request returns the creator profile fields together with the privacy choices and interaction settings that determine what the composer should allow. Use the returned privacyLevelOptions, commentDisabled, duetDisabled, stitchDisabled, and maxVideoPostDurationSec values to shape the Post to TikTok experience before any upload is attempted.
Endpoint summary
This endpoint proxies TikTok's /v2/post/publish/creator_info/query/ endpoint and returns creator information for a connected TikTok account. The response is intended for building a compliant Post to TikTok user experience: the profile fields identify the creator, while the settings fields tell the composer which privacy levels are available, which interaction toggles must be disabled, and how long a video may be. Fetch this information before presenting posting controls, rather than assuming defaults that may not match the connected creator's settings.
Authorization and query parameters
Send the request with the accessKey credential in the x-access-key header, using a token placeholder in place of the actual value. The only query parameter is accountId, an optional string containing the integration ID of the TikTok account. When accountId is omitted, the request uses the first connected TikTok account, so callers with a single connected account can omit it entirely. Callers supporting multiple connected accounts should pass accountId explicitly to avoid ambiguity about which creator's settings are returned.
200 response: creator profile fields
A successful 200 response contains a required boolean success field, an optional data object, and an optional string error field. Inside data, creatorAvatarUrl, creatorUsername, and creatorNickname are each required but nullable strings: the avatar URL returned by TikTok, the username handle, and the display name respectively. The creatorUsername field is the value to display as the creator's handle in the composer header. Because these fields can be null, the interface should handle a missing avatar, username, or nickname gracefully instead of assuming every profile field is populated.
200 response: privacyLevelOptions
The privacyLevelOptions field is a required array of strings listing the privacy levels available to this creator, and the composer must restrict the privacy dropdown to exactly these values. Each entry is one of PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, or SELF_ONLY, so the dropdown should be rendered from the returned array rather than from a hardcoded list. If a previously selected privacy level is not present in the returned options, it should not be offered for this creator.
200 response: comment, duet, and stitch settings
Three required boolean fields describe the creator's interaction settings: commentDisabled, duetDisabled, and stitchDisabled. When commentDisabled is true, the creator has disabled comments in their app settings and the Allow Comment toggle should be greyed out. When duetDisabled is true, the Allow Duet toggle should be greyed out, and when stitchDisabled is true, the Allow Stitch toggle should be greyed out. Treating a true value as a hard restriction, rather than a default that the user can override, keeps the composer aligned with the creator's actual settings.
200 response: maxVideoPostDurationSec
The maxVideoPostDurationSec field is a required number giving the maximum video duration, in seconds, that this creator may post. The composer should compare the selected video's duration against this value and reject videos longer than the limit before upload, surfacing the limit to the user so they can trim or replace the video. Because the limit comes from the creator's own settings, it can differ between accounts, which is another reason to fetch creator info for the specific accountId being used.
Worked request and response example
The worked request example shows the exact GET method and path with the x-access-key header, both with the default account and with an explicit accountId query parameter. The example 200 response body shows the full field map with placeholder values, including PUBLIC_TO_EVERYONE as a sample privacyLevelOptions entry. Placeholder values in the examples are illustrative only and should be replaced with real values returned by the endpoint at runtime.
404 and 502 error responses
Both 404 and 502 responses return an application/json body containing a single required string error field and no data object. Client code should branch on the status code, read the error string for display or logging, and avoid assuming that creator settings are available in either case. The supplied contract does not define a more specific cause for either status, so the composer should treat both as failures to obtain creator info and should not fall back to invented defaults for privacy, interaction toggles, or duration.
Posting UX decision checklist
Before showing the composer, fetch creator info for the target account and apply four checks. Restrict the privacy dropdown to the returned privacyLevelOptions values. Grey out the Allow Comment toggle when commentDisabled is true, the Allow Duet toggle when duetDisabled is true, and the Allow Stitch toggle when stitchDisabled is true. Reject any video whose duration exceeds maxVideoPostDurationSec before upload. Finally, display creatorUsername and creatorNickname to confirm the correct connected account is being used, and handle null profile fields without breaking the composer layout.
| Field | Type | Required | Description and required UX action |
|---|---|---|---|
| success | boolean | Yes | Top-level success flag in the 200 response. |
| data | object | No | Creator info object containing the fields below. |
| data.creatorAvatarUrl | string | null | Yes | Profile avatar URL returned by TikTok; display as the creator avatar, handling null. |
| data.creatorUsername | string | null | Yes | Username (@handle) of the creator; display as the creator handle, handling null. |
| data.creatorNickname | string | null | Yes | Display name of the creator; display as the creator name, handling null. |
| data.privacyLevelOptions | array<string> | Yes | Privacy levels available to this creator; restrict the privacy dropdown to these values. Enum: PUBLIC_TO_EVERYONE | MUTUAL_FOLLOW_FRIENDS | FOLLOWER_OF_CREATOR | SELF_ONLY. |
| data.commentDisabled | boolean | Yes | If true, comments are disabled in the creator's app settings; grey out the Allow Comment toggle. |
| data.duetDisabled | boolean | Yes | If true, duet is disabled in the creator's app settings; grey out the Allow Duet toggle. |
| data.stitchDisabled | boolean | Yes | If true, stitch is disabled in the creator's app settings; grey out the Allow Stitch toggle. |
| data.maxVideoPostDurationSec | number | Yes | Maximum video duration in seconds this creator may post; reject longer videos before upload. |
| error | string | No | Optional error string in the 200 response. |
Exact preserved contract; nullability and enum values as supplied.
| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
| x-access-key | Header | string (<token>) | Yes | accessKey credential sent in the x-access-key header. |
| accountId | Query | string | No | Integration ID of the TikTok account. If omitted, uses the first connected TikTok account. |
Exact preserved contract.
| Status | Content type | Body fields | Client handling |
|---|---|---|---|
| 200 | application/json | success (boolean, required), data (object, optional), error (string, optional) | Apply the field map: restrict privacy choices, grey out disabled toggles, and reject over-duration videos. |
| 404 | application/json | error (string, required) | Creator info was not obtained; read error and do not assume creator settings. |
| 502 | application/json | error (string, required) | Creator info was not obtained; read error and do not assume creator settings. |
404 and 502 causes are not defined in the supplied source; only the shared error contract is preserved.
curl -X GET "{{API_BASE_URL}}/v1/tiktok/creator-info" \
-H "x-access-key: <token>"curl -X GET "{{API_BASE_URL}}/v1/tiktok/creator-info?accountId=<accountId>" \
-H "x-access-key: <token>"{
"success": true,
"data": {
"creatorAvatarUrl": "string",
"creatorUsername": "string",
"creatorNickname": "string",
"privacyLevelOptions": [
"PUBLIC_TO_EVERYONE"
],
"commentDisabled": true,
"duetDisabled": true,
"stitchDisabled": true,
"maxVideoPostDurationSec": 0
},
"error": "string"
}{
"error": "string"
}| Scope | Field | Type | Type reference | Required | Description | Constraints |
|---|---|---|---|---|---|---|
| response#1 | response | object | __0 | |||
| response#1 | response.success | boolean | __1 | Yes | ||
| response#1 | response.data | object | __2 | No | ||
| response#1 | response.data.creatorAvatarUrl | string | null | __3 | Yes | Profile avatar URL returned by TikTok. | |
| response#1 | response.data.creatorAvatarUrl[variant1] | string | __3_extends:__4 | Profile avatar URL returned by TikTok. | ||
| response#1 | response.data.creatorAvatarUrl[variant2] | null | __3_extends:__5 | Profile avatar URL returned by TikTok. | ||
| response#1 | response.data.creatorUsername | string | null | __6 | Yes | Username (@handle) of the creator. | |
| response#1 | response.data.creatorUsername[variant1] | string | __6_extends:__7 | Username (@handle) of the creator. | ||
| response#1 | response.data.creatorUsername[variant2] | null | __6_extends:__8 | Username (@handle) of the creator. | ||
| response#1 | response.data.creatorNickname | string | null | __9 | Yes | Display name of the creator. | |
| response#1 | response.data.creatorNickname[variant1] | string | __9_extends:__10 | Display name of the creator. | ||
| response#1 | response.data.creatorNickname[variant2] | null | __9_extends:__11 | Display name of the creator. | ||
| response#1 | response.data.privacyLevelOptions | array<string> | __12 | Yes | Privacy levels available to this creator. Your UX must restrict the privacy dropdown to these values. | |
| response#1 | response.data.privacyLevelOptions[] | string | __13 | kind: schemaValueIn; value: "PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY" | ||
| response#1 | response.data.commentDisabled | boolean | __14 | Yes | If true, the creator has disabled comments in their app settings — grey out the Allow Comment toggle. | |
| response#1 | response.data.duetDisabled | boolean | __15 | Yes | If true, the creator has disabled duet in their app settings — grey out the Allow Duet toggle. | |
| response#1 | response.data.stitchDisabled | boolean | __16 | Yes | If true, the creator has disabled stitch in their app settings — grey out the Allow Stitch toggle. | |
| response#1 | response.data.maxVideoPostDurationSec | number | __17 | Yes | Maximum video duration (in seconds) this creator may post. Reject videos longer than this before upload. | |
| response#1 | response.error | string | __18 | No | ||
| response#2 | response | object | __0 | |||
| response#2 | response.error | string | __1 | Yes |