# List authorized creators

- API version: 1.11.0
- Last updated: 2026-11-16
- Server: `https://api.ailingtu.com`
- Web document: [List authorized creators](/en/openapi/creators)
- Full schema: [JSON Schema](/en/openapi/operations/listCreatorAccounts.json)
- Discovery: [Operation index](/en/openapi/operations/index.json)

## GET /v1/creatorAccount/pageList

Operation ID: `listCreatorAccounts`

List authorized TikTok Shop creators, regions, and posting permissions. Use id for product queries and creatorId when creating a post.

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.

### Request parameters

| Field | Location | Type | Required | Description |
|---|---|---|---|---|
| `pageSize` | query | integer | Yes | Items per page, up to 200 |
| `pageNumber` | query | integer | Yes | Page number, starting at 1 |
| `valid` | query | boolean | No | Return valid authorizations only; defaults to true |
| `authSource` | query | string | No | Use TIKTOK_SHOP_CREATOR for commerce posts |
| `usernames` | query | string[] | No | Repeat the query parameter for multiple usernames |
| `selectionRegion` | query | string | No | Target region, such as US |
| `hasPhotoPermission` | query | boolean | No | Return accounts with shoppable photo permission only |
| `ids` | query | integer[] | No | Account IDs; an empty array returns an empty page. Omission disables this filter; company/member permissions still apply. |
| `username` | query | string | No | Username filter |
| `registerRegion` | query | string | No | Registration region |
| `tagName` | query | string | No | Tag name |

### Success response

```json
{
  "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 fields

Main levels are listed below. The endpoint JSON Schema is authoritative for the full structure, unions and validation rules; Required refers to 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. |

### Integration notes and limits

- 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.

### Error handling

| HTTP | Description |
|---|---|
| 400 | The request parameters or body are invalid. Fix them and retry. |
| 401 | The API key is missing or invalid. Check x-api-key. |
| 403 | The API key has no permission to call this endpoint. |
| 429 | Too many requests. Retry with exponential backoff. |
| 500 | The server failed. Retry transient failures with exponential backoff. |

Treat any non-zero business code as a failure. Do not blindly retry parameter, permission or authorization errors. If creating a publishing or generation task times out, query the existing task first instead of creating another one.
