Get Categories

GET

/product/202309/categories

Retrieve the list of product categories available for your shop. Product categories are updated frequently, so it’s recommended to call the API in real time to ensure you are using the latest category data. Caching category data locally may result in using outdated information, leading to errors when creating products. For the Indonesia market: To list a product on both TikTok Shop and Tokopedia, use only categories available on both platforms. Call this API once with listing_platform set to TIKTOK_SHOP and once with it set to TOKOPEDIA, then identify the categories returned by both calls.

Authorizations

• accessToken

Parameters

Query Parameters

shop_cipher

required

string

Identifies the shop. Obtain it from the Get Authorized Shops API.

locale

string

Allowed values: cs-CZ de-AT de-BE de-DE el-GR en-GB en-IE en-US es-ES es-MX fr-FR fr-BE hu-HU id-ID it-IT ja-JP ms-MY nl-NL nl-BE pl-PL pt-BR pt-PT th-TH vi-VN zh-CN

The BCP-47 locale codes for displaying category information. Default: The default locale of your shop. Possible values:

• cs-CZ
• de-AT
• de-BE
• de-DE
• el-GR
• en-GB
• en-IE
• en-US
• es-ES
• es-MX
• fr-FR
• fr-BE
• hu-HU
• id-ID
• it-IT
• ja-JP
• ms-MY
• nl-NL
• nl-BE
• pl-PL
• pt-BR
• pt-PT
• th-TH
• vi-VN
• zh-CN

keyword

string

Filter categories by this keyword in local_name.

category_version

string

Filter categories by the category tree version.Possible values based on region:

• US, EU and SEA: v2, represents the 7-level category tree. Important: For US, EU and SEA shops, you must pass v2 when using this API.
• Other regions: v1, represents the 3-level category tree.Default: v1

listing_platform

string

Allowed values: TIKTOK_SHOP TOKOPEDIA

Filter categories by the specified platform. Possible values:

• TIKTOK_SHOP
• TOKOPEDIA Default: TIKTOK_SHOP

Applicable only for sellers that migrated from Tokopedia.

include_prohibited_categories

boolean

A flag to indicate whether to include categories that are prohibited on TikTok Shop. Set this to true to identify which are the product categories that you can’t list on TikTok Shop in any circumstances. Applicable only for BR, MX, EU and SEA markets.

is_live_quick

boolean

False — NORMAL products true — LIVE_QUICK products. Only seller with the required permissions can creat LIVE_QUICK products. Default: false

Responses

200

Success

Media typeapplication/json

object

code

Status code; 0 means success.

integer format: int64

message

Success or failure message.

string

request_id

Request log ID.

string

data

object

categories

The list of categories that meet the query conditions.

Array<object>

object

id

The category ID.

string

parent_id

The parent category ID. For the root category, the parent ID is 0.

string

local_name

The category name in the requested locale. If locale is omitted, the default locale of your shop is used.

string

is_leaf

A flag to indicate if the category is a leaf category.

Note: You can only create or edit products that belong to a leaf category.

boolean

permission_statuses

The shop’s permission statuses for this category. Possible values:

• AVAILABLE: None of the category-permission restrictions listed below applies to this category. To create or edit a product in the category, is_leaf must be true.
• INVITE_ONLY: This is a restricted category and you do not have permission to use it. Submit an application through the Qualification Center on TikTok Shop Seller Center to gain access. In Seller Center, INVITE_ONLY is also known as “restricted”.
• NON_MAIN_CATEGORY: This category is out of scope for this shop, and you do not have permission to use it. Contact your account manager for assistance.
• PROHIBITED: This category is prohibited on TikTok Shop. Do not attempt to list products in this category as they will be rejected during audit. Applicable only for BR, MX, EU and SEA markets.

Array<string>

Allowed values: AVAILABLE INVITE_ONLY NON_MAIN_CATEGORY PROHIBITED

Example

{
  "code": 0,
  "data": {
    "categories": [
      {
        "id": "600002",
        "parent_id": "600001",
        "local_name": "Home Supplies",
        "is_leaf": false,
        "permission_statuses": [
          "INVITE_ONLY",
          "NON_MAIN_CATEGORY"
        ]
      }
    ]
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}