Developer docs / Creator authorization
List authorized creators
List authorized TikTok Shop creators, regions, and posting permissions. Use id for product queries and creatorId when creating a post.
GET
/v1/creatorAccount/pageList- Authentication:
- Request header x-api-key: <YOUR_API_KEY>; keep the key on the server and never expose it in client code, logs or shared files.
- Success criteria:
- HTTP 2xx with code=0; for asynchronous tasks, also query the final status.
Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
pageSize | integer | Yes | Items per page, up to 200 |
pageNumber | integer | Yes | Page number, starting at 1 |
valid | boolean | No | Return valid authorizations only; defaults to true |
authSource | string | No | Use TIKTOK_SHOP_CREATOR for commerce posts |
usernames | string[] | No | Repeat the query parameter for multiple usernames |
selectionRegion | string | No | Target region, such as US |
hasPhotoPermission | boolean | No | Return accounts with shoppable photo permission only |
ids | integer[] | No | Account IDs; an empty array returns an empty page. Omission disables this filter; company/member permissions still apply. |
username | string | No | Username filter |
registerRegion | string | No | Registration region |
tagName | string | No | Tag name |
For commerce videos, permissions containing both LIVE_STREAM_PERMISSION and SELF_SALE_PERMISSION guarantees video commerce permission.
Photo posts require PHOTO_SHOPPABLE_PERMISSION_PRODUCT or PHOTO_SHOPPABLE_PERMISSION_SHOP in permissions; without either, the account has no photo publishing permission.
Business authorization sources, bound shops and account managers are included in account data.
Success response
{
"code": 0,
"data": {
"list": [
{
"id": 12345,
"creatorId": "2077242233106595840",
"username": "shop_creator",
"authSource": "TIKTOK_SHOP_CREATOR",
"oauthRegion": "USA",
"registerRegion": "US",
"selectionRegion": "US",
"targetMarket": "US",
"valid": true,
"tagNames": [
"top-tier"
],
"permissions": [
"VIDEO_SHOPPABLE_PERMISSION",
"PHOTO_SHOPPABLE_PERMISSION_PRODUCT"
]
}
],
"total": 1,
"pageNumber": 1,
"pageSize": 200,
"totalPages": 1
},
"message": "success"
}Response and errors
Main response fields come from the published contract; see the JSON Schema. Required refers to the constraint in the containing object.
| Field | Type | Required | Description |
|---|---|---|---|
code | integer | Yes | Fixed value: 0 |
message | string | No | — |
data | object | Yes | — |
data.list | object[] | Yes | — |
data.list[].id | integer | Yes | Account record ID used by the product query endpoints. |
data.list[].creatorId | string | Yes | Creator business ID used when creating publishing tasks. |
data.list[].username | string | Yes | — |
data.list[].authSource | string | null | Yes | Authorization source; null for older records.; Allowed values: TIKTOK_LOGIN_KIT, TIKTOK_BUSINESS_ACCOUNT_API, TIKTOK_SHOP_CREATOR, |
data.list[].oauthRegion | string | No | — |
data.list[].registerRegion | string | No | — |
data.list[].selectionRegion | string | No | — |
data.list[].targetMarket | string | null | No | — |
data.list[].valid | boolean | Yes | — |
data.list[].tagNames | string[] | No | — |
data.list[].permissions | string[] | Yes | — |
data.list[].creatorUserId | string | No | — |
data.list[].avatar | string | No | — |
data.list[].sellerType | string | No | — |
data.list[].userType | string | No | — |
data.list[].creatorOpenId | string | No | — |
data.list[].shopId | integer | null | No | — |
data.list[].shopName | string | null | No | — |
data.list[].createdAt | string | No | — |
data.list[].managerList | object[] | No | — |
data.list[].managerList[].id | integer | No | — |
data.list[].managerList[].userId | integer | No | — |
data.list[].managerList[].displayName | string | No | — |
data.list[].managerAssigned | boolean | No | — |
data.total | integer | Yes | — |
data.pageNumber | integer | Yes | — |
data.pageSize | integer | Yes | — |
data.totalPages | integer | No | — |
timestamp | integer | No | Response timestamp in milliseconds. |
HTTP 400The request parameters or body are invalid. Fix them and retry.HTTP 401The API key is missing or invalid. Check x-api-key.HTTP 403The API key has no permission to call this endpoint.HTTP 429Too many requests. Retry with exponential backoff.HTTP 500The server failed. Retry transient failures with exponential backoff.
Fix parameter, permission or authorization errors before retrying. If task creation times out, query existing tasks first and do not submit duplicates after an interrupted poll.
Last updated · 2026-11-16