TikTok Shop Partner Center

https://partner.tiktokshop.com/docv2/page/
Admin
Documentation for TikTok Shop partners, including developers, agencies, and affiliates, providing...
Tokens:3,583
Snippets:18
Trust Score:8.1
Update:4 hours ago
Show doc for...
Tokens:
Raw
### JSON response example for Get Authorized Shops

Source: https://partner.tiktokshop.com/docv2/page/get-authorized-shops-202309

Example response showing a successful call with code 0. The data object contains a shops array with details like id, name, region, seller_type, cipher, and code. The cipher is used as input for shop-related APIs.

```json
{
  "code": 0,
  "data": {
    "shops": [
      {
        "id": "7000714532876273420",
        "name": "Maomao beauty shop",
        "region": "GB",
        "seller_type": "CROSS_BORDER",
        "cipher": "GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3",
        "code": "CNGBCBA4LLU8"
      }
    ]
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}
```

--------------------------------

### JSON response example for authorized category assets

Source: https://partner.tiktokshop.com/docv2/page/get-authorized-category-assets-202405

Example response showing a successful call with code 0. The data object contains an array of category_assets, each with a cipher, target market, and category details. The message field indicates success.

```json
{
  "code": 0,
  "data": {
    "category_assets": [
      {
        "cipher": "TTP_XF90igAAAABh0sddwer0qsWgt233vOiG",
        "target_market": "US",
        "category": {
          "id": 3,
          "name": "Customer Support"
        }
      }
    ]
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}
```

--------------------------------

### cURL request to Get Authorized Shops

Source: https://partner.tiktokshop.com/docv2/page/get-authorized-shops-202309

Use this cURL command to call the GET /authorization/202309/shops endpoint. It requires the app_key, sign, and timestamp query parameters, plus the content-type and x-tts-access-token headers. The response returns the list of authorized shops with their cipher values.

```bash
curl -X GET \
 'https://open-api.tiktokglobalshop.com/authorization/202309/shops?app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1623812664' \
-H 'content-type: application/json' \
-H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k'
```

--------------------------------

### cURL request to get authorized category assets

Source: https://partner.tiktokshop.com/docv2/page/get-authorized-category-assets-202405

Use this cURL command to call the GET /authorization/202405/category_assets endpoint. It requires the partner access token (x-tts-access-token) and query parameters sign, timestamp, and app_key. The response returns the list of authorized category assets with their ciphers.

```bash
curl -X GET \
 'https://open-api.tiktokglobalshop.com/authorization/202405/category_assets?sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1623812664&app_key=38abcd' \
 -H 'content-type: application/json' \
 -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k'
```

--------------------------------

### GET /authorization/202309/shops

Source: https://partner.tiktokshop.com/docv2/page/get-authorized-shops-202309

Retrieves the list of shops that a seller has authorized for an app. Use this API to check which shops are currently authorized and obtain the corresponding shop cipher for use as an input parameter in shop-related APIs.

```APIDOC
## [GET] /authorization/202309/shops

### Description
Retrieves the list of shops that a seller has authorized for an app. Seller authorization is required before an app can access the data of a shop. Use this API to check which shops are currently authorized for an app and obtain the corresponding shop cipher for use as an input parameter in shop related APIs.

### Method
GET

### Endpoint
/authorization/202309/shops

### Parameters
#### Header Parameters
- **content-type** (string) - Required - Allowed type: application/json
- **x-tts-access-token** (string) - Required - The seller access_token value from Get Access Token, when user_type = 0.

#### Query Parameters
- **app_key** (string) - Required - Every single app will have a unique key. Please use the specific key assigned to your app.
- **sign** (string) - Required - Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders.
- **timestamp** (int) - Required - Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests.

### Request Example
```
curl -X GET \
 'https://open-api.tiktokglobalshop.com/authorization/202309/shops?app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1623812664' \
 -H 'content-type: application/json' \
 -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k'
```

### Response
#### Success Response (200)
- **code** (int) - The success or failure status code returned in API response.
- **message** (string) - The success or failure messages returned in API response. Reasons of failure will be described in the message.
- **request_id** (string) - Request log
- **data** (object) - Specific return information
  - **shops** (array) - List of authorized shops
    - **id** (string) - Shop ID
    - **name** (string) - Shop name
    - **region** (string) - Shop region
    - **seller_type** (string) - Seller type (e.g., CROSS_BORDER)
    - **cipher** (string) - Shop cipher for use in shop-related APIs
    - **code** (string) - Shop code

#### Response Example
```json
{
  "code": 0,
  "data": {
    "shops": [
      {
        "id": "7000714532876273420",
        "name": "Maomao beauty shop",
        "region": "GB",
        "seller_type": "CROSS_BORDER",
        "cipher": "GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3",
        "code": "CNGBCBA4LLU8"
      }
    ]
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}
```

### Error Codes
- **36009003** - Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support.
```

--------------------------------

### GET /authorization/202405/category_assets

Source: https://partner.tiktokshop.com/docv2/page/get-authorized-category-assets-202405

Retrieves the list of business category assets authorized by a partner for an app. Use this API to check which business category assets are currently authorized for an app and obtain the corresponding category asset cipher for use as an input parameter in affiliate partner related APIs.

```APIDOC
## [GET] /authorization/202405/category_assets

### Description
Retrieves the list of business category assets authorized by a partner for an app. Partner authorization is required before an app can access the data of a partner, and this access is granted based on business categories. Use this API to check which business category assets are currently authorized for an app and obtain the corresponding category asset cipher for use as an input parameter in affiliate partner related APIs.

### Method
GET

### Endpoint
/authorization/202405/category_assets

### Parameters
#### Header Parameters
- **content-type** (string) - Required - Allowed type: application/json
- **x-tts-access-token** (string) - Required - The partner access_token value from Get Access Token, when user_type = 3. Follow this guide to get partner access_token.

#### Query Parameters
- **app_key** (string) - Required - Every single app will have a unique key. Please use the specific key assigned to your app.
- **sign** (string) - Required - Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders.
- **timestamp** (int) - Required - Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time.

### Request Example
```
curl -X GET \
 'https://open-api.tiktokglobalshop.com/authorization/202405/category_assets?sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1623812664&app_key=38abcd' \
 -H 'content-type: application/json' \
 -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k'
```

### Response
#### Success Response (200)
- **code** (int) - The success or failure status code returned in API response.
- **message** (string) - The success or failure messages returned in API response. Reasons of failure will be described in the message.
- **request_id** (string) - Request log
- **data** (object) - Specific return information
  - **category_assets** (array) - List of authorized category assets
    - **cipher** (string) - Category asset cipher
    - **target_market** (string) - Target market
    - **category** (object) - Category details
      - **id** (int) - Category ID
      - **name** (string) - Category name

#### Response Example
```json
{
  "code": 0,
  "data": {
    "category_assets": [
      {
        "cipher": "TTP_XF90igAAAABh0sddwer0qsWgt233vOiG",
        "target_market": "US",
        "category": {
          "id": 3,
          "name": "Customer Support"
        }
      }
    ]
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}
```

### Error Code
Empty. No business logic error codes.
```
Tokens:
Raw