| category_id | string | The ID of the category of this product. - It must be a leaf category that corresponds to the category tree type specified in the category_version property. - It must be a main category (categories.permission_statuses=AVAILABLE in Get Global Categories API).Note: Refer to TikTok Shop Academy for information on product category restrictions. |
| brand_id | string | The ID of the brand of this product.Note: Unauthorized brands won't be displayed on TikTok Shop. |
| main_images | []object | A list of images to display in the product image gallery.- Max count: 9- Arrange your image URIs in the sequence that they should appear on TikTok Shop.- Image dimensions: [300x300 px, 4000x4000 px] Recommendations:- Use a minimum of 5 images.- The first image should have a white background. Use the Optimize Images API to change the background to white. |
| skus | []object | A list of global Stock Keeping Units (SKUs) used to identify distinct variants of the product.Note:- Max SKUs for EU, JP, UK, US: 300- Max SKUs for other regions: 100Recommendations: Place the most important variant at the beginning of the array. |
| package_weight | object | The weight of the product package.Note:- Provide the weight measured after packing the product.- This value impacts the shipping cost, so it is important to ensure that the measurements are accurate. Any discrepancies may lead to additional shipping fees.- The package weight will take precedence over package dimensions in fee calculation if the fee based on weight is higher. |
| certifications | []object | The list of certifications for your product.Max count: 10As per TikTok Shop guidelines, certifications are required for certain restricted product categories. Retrieve the certification requirements for your product from the Get Global Category Rules API. Refer to TikTok Shop Restricted Products Policy for information on product category restrictions. |
| package_dimensions | object | The dimensions of the product package.Note:- Provide the dimensions measured after packing the product.- These values impact the shipping cost, so it is important to ensure that dimensions are accurate. Any discrepancies may lead to additional shipping fees. |
| product_attributes | []object | A list of general attributes (e.g. manufacturer, country of origin, materials used) that describe the product as a whole, regardless of variant.Important: The attributes available for use are determined by the system based on the product's assigned category, with some being mandatory. You must provide the product attributes marked as is_required in the response of the Get Global Attributes API. |
| size_chart | object | The measurement details of the product to help buyers find the right size.Note: - For certain product categories, size charts may be required or not supported. Use the Get Global Category Rules API to check the requirements.- If size charts are not supported, even if you provide a size chart here, the size chart will not be saved.- Provide either a TikTok Shop size chart template ID or a size chart image; if both are provided, the ID takes priority. |
| video | object | A product introduction or promotion video to display for your product.Recommendations:- Aspect ratio: 1:1 - Resolution: HD 720p or higher- Duration: 20 - 60 seconds |
| manufacturer | object | (Deprecated: This field is deprecated and will be removed in a future API version. Use manufacturer_ids instead.)The product manufacturer's details. |
| manufacturer_ids | []string | A comma-delimited list of manufacturer IDs. Retrieve the IDs from the Search Manufacturers API.Default: The IDs provided when the global product was created.Note: Applicable only for the EU market in certain categories. Use the Get Global Category Rules API to check the requirements. |
| responsible_person_ids | []string | A comma-delimited list of responsible person IDs. Retrieve the IDs from the Search Responsible Persons API.Default: The IDs provided when the global product was created.Note: Applicable only for the EU market in certain categories. Use the Get Global Category Rules API to check the requirements. |
| category_version | string | The category tree version to assign this product to.Possible values based on region:- US: v2, represents the 7-level category tree. Important: If the seller account contains an active US shop, you must pass v2 when using this API.- Other regions: v1, represents the 3-level category tree.Default: v1 |
| external_global_product_id | string | An external identifier used in an external ecommerce platform. This is used to associate the global product between TikTok Shop and the external ecommerce platform. Max length: 999 characters |