Get Global Category 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.

---

For common parameters, refer to How to call TikTok Shop APIs - Common Parameters

• 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 |N |en-GB |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 |

Query

https://open-api.tiktokglobalshop.com/product/202309/categories/600001/global_rules?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&category_version=v1&locale=en-GB

• 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. | ^^sample_image_url |string |https://p-boei18n.byted.org/tos-boei18n-i-jvtte31kaf/80b32f2896829eeb69d4b278c4f3aa75.jpg~tplv-jvtte31kaf-origin-jpeg.jpeg |The URL to view an image of the sample certification document. | ^^required_regions |[]string |["GB","MY","PH","SG","TH","VN"] |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. | ^^optional_regions |[]string |["US"] |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:

• 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. | ^^requirement_conditions |[]object | |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. | ^^^region |string |IE |The market where the certification is required when the conditions are met. 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 | ^^^condition_type |string |VALUE_ID_MATCH |The type of condition, such as matching values, or range comparisons. Possible values:
• VALUE_ID_MATCH: The condition is true when the seller selects a value whose ID matches the one specified in this condition. | ^^^attribute_id |string |101610 |The ID of the product attribute that is being evaluated by the condition. | ^^^attribute_value_id |string |1024358 |The ID of the product attribute value that must match the seller's input for the condition to be true. | ^size_chart |object | |Size chart related rules. | ^^is_supported |bool |true |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. | ^^is_required |bool |true |A flag to indicate whether a size chart is required. | ^responsible_person |object | |Responsible person rules. If this is empty, it means a responsible person is not required for this category. Applicable only for EU markets. | ^^is_required |bool |false |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. | ^^optional_regions |[]string |["IE"] |The markets where the responsible person is optional. Possible values:
• DE: Germany
• ES: Spain
• FR: France
• IT: Italy
• IE: Ireland | ^^required_regions |[]string |["DE","ES"] |The markets where the responsible person is required. Possible values:
• DE: Germany
• ES: Spain
• FR: France
• IT: Italy
• IE: Ireland | ^manufacturer |object | |Manufacturer rules. If this is empty, it means a manufacturer is not required for this category.

Applicable only for EU markets. | ^^is_required |bool |false |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. | ^^optional_regions |[]string |["IE"] |The markets where the manufacturer is optional. Possible values:
• DE: Germany
• ES: Spain
• FR: France
• IT: Italy
• IE: Ireland | ^^required_regions |[]string |["DE","ES"] |The markets where the manufacturer is required. Possible values:
• DE: Germany
• ES: Spain
• FR: France
• IT: Italy
• IE: Ireland |

{"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"}

For common error codes, refer to How to call TikTok Shop APIs - Common Error Code