Skip to content
TikTok Shop Partner API

Get Global Category Rules

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

Retrieve the additional requirements (beyond mandatory product attributes) for listing a global product in a particular category, regardless of market variations. 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 global 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”
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 required globally.

  • true: The certification is required in all regions.
  • false: The certification is required only in some regions, or if certain conditions are met. Refer to required_regions and requirement_conditions for the specific requirements.
boolean
sample_image_url

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

string
required_regions

The markets where the certification is required, without conditions. Possible values:

  • DE: Germany
  • ES: Spain
  • FR: France
  • GB: United Kingdom
  • ID: Indonesia
  • IT: Italy
  • IE: Ireland
  • JP: Japan
  • MY: Malaysia
  • PH: Philippines
  • SG: Singapore
  • TH: Thailand
  • US: United States
  • VN: Vietnam
  • MX: Mexico

Applicable only if is_required=false.

Array<string>
Allowed values: DE ES FR GB ID IT IE JP MY PH SG TH US VN MX
optional_regions

The markets where the certification is purely optional, or required only under certain conditions. Refer to requirement_conditions for details on markets with conditional requirements.

Possible values:

  • AT: Austria
  • BE: Belgium
  • CZ: Czechia
  • DE: Germany
  • ES: Spain
  • FR: France
  • GB: United Kingdom
  • GR: Greece
  • HU: Hungary
  • ID: Indonesia
  • IE: Ireland
  • IT: Italy
  • JP: Japan
  • MX: Mexico
  • MY: Malaysia
  • NL: Netherlands
  • PH: Philippines
  • PL: Poland
  • PT: Portugal
  • SG: Singapore
  • TH: Thailand
  • US: United States
  • VN: Vietnam

Applicable only if is_required=false.

Array<string>
Allowed values: AT BE CZ DE ES FR GB GR HU ID IE IT JP MX MY NL PH PL PT SG TH US VN
requirement_conditions

A list of conditions that determine if the certification is required in a market 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.

Applicable only if optional_regions is not empty.

Array<object>
object
region

The market where the certification is required when the conditions are met. Possible values:

  • AT: Austria
  • BE: Belgium
  • CZ: Czechia
  • DE: Germany
  • ES: Spain
  • FR: France
  • GB: United Kingdom
  • GR: Greece
  • HU: Hungary
  • ID: Indonesia
  • IE: Ireland
  • IT: Italy
  • JP: Japan
  • MX: Mexico
  • MY: Malaysia
  • NL: Netherlands
  • PH: Philippines
  • PL: Poland
  • PT: Portugal
  • SG: Singapore
  • TH: Thailand
  • US: United States
  • VN: Vietnam
string
Allowed values: AT BE CZ DE ES FR GB GR HU ID IE IT JP MX MY NL PH PL PT SG TH US VN
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
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
responsible_person

Responsible person rules. If this is empty, it means a responsible person is not required for this category.

Applicable only for EU markets.

object
is_required

A flag to indicate whether the responsible person is required for all EU markets.

  • true: The manufacturer is required in all EU markets.
  • false: The manufacturer is required only in some EU markets. Refer to required_regions and optional_regions for details.
boolean
optional_regions

The markets where the responsible person is optional. Possible values:

  • DE: Germany
  • ES: Spain
  • FR: France
  • IT: Italy
  • IE: Ireland
Array<string>
Allowed values: DE ES FR IT IE
required_regions

The markets where the responsible person is required. Possible values:

  • AT: Austria
  • BE: Belgium
  • CZ: Czechia
  • DE: Germany
  • ES: Spain
  • FR: France
  • GR: Greece
  • HU: Hungary
  • IE: Ireland
  • IT: Italy
  • NL: Netherlands
  • PL: Poland
  • PT: Portugal
Array<string>
Allowed values: AT BE CZ DE ES FR GR HU IE IT NL PL PT
manufacturer

Manufacturer rules. If this is empty, it means a manufacturer is not required for this category.

Applicable only for EU markets.

object
is_required

A flag to indicate whether the manufacturer is required for all EU markets.

  • true: The manufacturer is required in all EU markets.
  • false: The manufacturer is required only in some EU markets. Refer to required_regions and optional_regions for details.
boolean
optional_regions

The markets where the manufacturer is optional. Possible values:

  • DE: Germany
  • ES: Spain
  • FR: France
  • IT: Italy
  • IE: Ireland
Array<string>
Allowed values: DE ES FR IT IE
required_regions

The markets where the manufacturer is required. Possible values:

  • AT: Austria
  • BE: Belgium
  • CZ: Czechia
  • DE: Germany
  • ES: Spain
  • FR: France
  • GR: Greece
  • HU: Hungary
  • IE: Ireland
  • IT: Italy
  • NL: Netherlands
  • PL: Poland
  • PT: Portugal
Array<string>
Allowed values: AT BE CZ DE ES FR GR HU IE IT NL PL PT
Example
{
  "code": 0,
  "data": {
    "product_certifications": [
      {
        "id": "7267563252536723205",
        "name": "product_cert_name",
        "is_required": false,
        "sample_image_url": "https://p-boei18n.byted.org/tos-boei18n-i-jvtte31kaf/80b32f2896829eeb69d4b278c4f3aa75.jpg~tplv-jvtte31kaf-origin-jpeg.jpeg",
        "required_regions": [
          "GB",
          "MY",
          "PH",
          "SG",
          "TH",
          "VN"
        ],
        "optional_regions": [
          "US"
        ],
        "requirement_conditions": [
          {
            "region": "IE",
            "condition_type": "VALUE_ID_MATCH",
            "attribute_id": "101610",
            "attribute_value_id": "1024358"
          }
        ]
      }
    ],
    "size_chart": {
      "is_supported": true,
      "is_required": true
    },
    "responsible_person": {
      "is_required": false,
      "optional_regions": [
        "IE"
      ],
      "required_regions": [
        "DE",
        "ES"
      ]
    },
    "manufacturer": {
      "is_required": false,
      "optional_regions": [
        "IE"
      ],
      "required_regions": [
        "DE",
        "ES"
      ]
    }
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}
DocsSDKsAPI Reference

Start here

Getting StartedConceptsAuthorizationWebhooksErrors

SDKs

Choose an SDK

OpenAPI

The spec