Skip to content
TikTok Shop Partner API

Get Category Rules

GET
/product/202309/categories/{category_id}/rules

Retrieve the additional requirements (beyond mandatory product attributes) for listing a product in a particular category based on your shop’s location. Requirements may include product certifications, size charts, dimensions and more. Use this API to determine the supporting information that you must prepare before listing a product. Note: It must be a leaf category that corresponds to the category tree type specified in the category_version property.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
category_id
required
string

The ID of the category. It must be a leaf category.

Query Parameters

Section titled “Query Parameters”
shop_cipher
required
string

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

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

Responses

Section titled “Responses”

200

Section titled “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
product_certifications

Certification related rules. As per TikTok Shop guidelines, certifications are required for certain restricted product categories. Refer to TikTok Shop Restricted Products Policy for information on product category restrictions.

If this is empty, it means certifications are not required for this category.

Array<object>
object
id

The ID to identify the type of certification required.

string
name

The name of the certification type.

string
is_required

A flag to indicate if the certification is always required when creating or editing a product.

  • true: The certification is always required.
  • false: The certification is not required, or required only if certain conditions are met. Refer to requirement_conditions for the specific requirements.
boolean
document_details

Details about the certification documents that you must submit, including the content, format, and any other guidelines.

string
sample_image_url

The URL to view an image of the sample certification document.

string
requirement_conditions

A list of conditions that determine if the certification is required based on the seller’s inputs for a product attribute. If any of the conditions is met, the certification is required; otherwise, it is optional.

For example, there’s a condition that states that the “Safety Data Sheet (SDS) for flammable materials” certification is required if the seller selects the value “Yes” for the attribute “Flammable Liquid?”. For more scenario-based guidance on using this parameter, refer to the Solution Guide - CAT-PRE-HAZMAT.

Applicable only if is_required=false.

Array<object>
object
condition_type

The type of condition. Possible values:

  • VALUE_ID_MATCH: The condition is true when the seller selects a value whose ID matches the one specified in this condition.
string
Allowed values: VALUE_ID_MATCH
attribute_id

The ID of the product attribute that is being evaluated by the condition.

string
attribute_value_id

The ID of the product attribute value that must match the seller’s input for the condition to be true.

string
expiration_date

Certification expiration date related rules.

object
is_required

A flag to indicate whether an expiration date is required for this certification.

boolean
size_chart

Size chart related rules.

object
is_supported

A flag to indicate whether size charts are supported.

Note: If size charts are not supported, even if you provide a size chart when creating or editing a product, the size chart will not be saved.

boolean
is_required

A flag to indicate whether a size chart is required.

boolean
measurement_and_options

Measurement rules grouped by measurement basis.

Array<object>
object
measurement_type

Possible values: GENERIC_MEASUREMENTS: generic measurements for categories that do not distinguish body and product measurements; BODY_MEASUREMENTS: shopper body measurements; PRODUCT_MEASUREMENTS: finished-product or garment measurements.

string
Allowed values: GENERIC_MEASUREMENTS BODY_MEASUREMENTS PRODUCT_MEASUREMENTS
options

Online measurement options for this group.

Array<object>
object
name

Localized measurement name resolved using the request locale.

string
id

Platform-defined standard measurement ID, for example size_chart_option_bust. Use this ID as table.headers[].id for the corresponding standard measurement.

string
role

Possible values: KEY: a key category measurement; RECOMMEND: a useful recommended measurement.

string
Allowed values: KEY RECOMMEND
unit

Possible values: NONE: no unit conversion; LENGTH: length values such as cm or in; WEIGHT: weight values such as kg or lb; HEIGHT: person-height values such as cm or ft/in.

string
Allowed values: NONE LENGTH WEIGHT HEIGHT
metric_value_range

Allowed metric range in [minimum, maximum] order.

Array<string>
imperial_value_range

Allowed imperial range in [minimum, maximum] order.

Array<string>
size_types

Available size types configured for this category. Use values returned in this list for size_chart_data.size_types when creating or editing a size chart. Possible values include: size_chart_common_size_type: Common; size_chart_size_type_regular: Regular; size_chart_size_type_juniors: Juniors; size_chart_size_type_plus: Plus; size_chart_size_type_big&tall: Big & Tall; size_chart_size_type_petite: Petite. This field is omitted when size types do not apply to the category.

Array<string>
cod

Cash on Delivery (COD) related rules. Applicable only for the following markets:

  • Global sellers: MY, PH, SA, TH, VN
  • Local sellers: ID, MY, PH, SA, TH, VN
object
is_supported

A flag to indicate whether COD is supported.

Note: If COD is not supported, but you set is_cod_allowed=true when creating or editing a product, the listing will fail.

boolean
package_dimension

Package dimension related rules.

object
is_required

A flag to indicate whether package dimensions are required.

boolean
epr

Extended Producer Responsibility (EPR) related rules.

object
is_required

A flag to indicate whether EPR is required.

boolean
responsible_person

Responsible person (RP) related rules. Applicable only for the EU market.

object
is_required

A flag to indicate whether the responsible person information is required.

boolean
manufacturer

Manufacturer related rules. Applicable only for the EU market.

object
is_required

A flag to indicate whether the manufacturer information is required.

boolean
allowed_special_product_types

The list of special product types, excluding regular products, that your shop is allowed to list in this category.

Possible values based on the region: US

  • PRE_ORDER: The product is not yet available or released. Fulfillment can be extended by specifying a release date.
  • MADE_TO_ORDER: The product is produced only after the order is received. Fulfillment can be extended by specifying a duration.
  • CUSTOM: The product requires a fulfillment timeline that exceeds the standard due to other factors. Fulfillment can be extended by specifying a duration.

UK and SEA

  • PRE_ORDER: The product is not yet available or released. Fulfillment can be extended by specifying a duration.

Note: This field is omitted if you lack the permission to list special product types. Contact your account manager for assistance if you wish to list such products.

Array<string>
Allowed values: PRE_ORDER MADE_TO_ORDER CUSTOM
fees

Product fees related rules.

Array<object>
object
type

The type of fee. Possible values: PFAND

string
Allowed values: PFAND
is_required

A flag to indicate whether information about the fee is required.

boolean
seller_sku

Seller SKU related rules. Applicable only for cross-border POP shops in EU markets.

object
is_required

A flag to indicate whether a Seller SKU is required when creating or editing a product in this category. When required, the Seller SKU must be 6 to 50 characters long and can contain only letters, digits, hyphens (-) and underscores (_).

boolean
Example
{
  "code": 0,
  "data": {
    "product_certifications": [
      {
        "id": "602362",
        "name": "SNI Certificate",
        "is_required": true,
        "document_details": "Upload a user manual or instructions in the official local language.\n\nWhere there are multiple items sold as a part of a bundle, please clearly indicate which specific product the certification pertains to in the uploaded file or image.",
        "sample_image_url": "https://p-boei18n.byted.org/tos-boei18n-i-jvtte31kaf/80b32f2896829eeb69d4b278c4f3aa75.jpg~tplv-jvtte31kaf-origin-jpeg.jpeg",
        "requirement_conditions": [
          {
            "condition_type": "VALUE_ID_MATCH",
            "attribute_id": "101610",
            "attribute_value_id": "1024358"
          }
        ],
        "expiration_date": {
          "is_required": true
        }
      }
    ],
    "size_chart": {
      "is_supported": true,
      "is_required": true,
      "measurement_and_options": [
        {
          "measurement_type": "BODY_MEASUREMENTS",
          "options": [
            {
              "name": "Bust",
              "id": "size_chart_option_bust",
              "role": "KEY",
              "unit": "LENGTH",
              "metric_value_range": [
                "70",
                "160"
              ],
              "imperial_value_range": [
                "27.5",
                "63"
              ]
            }
          ]
        }
      ],
      "size_types": [
        "size_chart_size_type_regular",
        "size_chart_size_type_petite"
      ]
    },
    "cod": {
      "is_supported": true
    },
    "package_dimension": {
      "is_required": true
    },
    "epr": {
      "is_required": false
    },
    "responsible_person": {
      "is_required": false
    },
    "manufacturer": {
      "is_required": false
    },
    "allowed_special_product_types": [
      "PRE_ORDER"
    ],
    "fees": [
      {
        "type": "PFAND",
        "is_required": true
      }
    ],
    "seller_sku": {
      "is_required": true
    }
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}
DocsSDKsAPI Reference

Start here

Getting StartedConceptsAuthorizationWebhooksErrors

SDKs

Choose an SDK

OpenAPI

The spec