POST Recommend Global Categories

Recommend Global Categories Seller Required scope: seller.global_product.category.info Retrieve the recommended categories for a candidate global product based on its title, description, and images. If you are syncing product catalogs from an external system to TikTok Shop, use this API to facilitate product classification. Note: Double-byte characters (e.g. Chinese characters) are not supported in text fields such as descriptions and titles. If you include them, the API request will fail. Version 202309

POST/product/202309/global_categories/recommend

Request

Header

Properties	Type	Description
content-type Required	string	Allowed type: application/json
x-tts-access-token Required	string	The seller access_token value from Get Access Token, when user_type = 0. Follow this guide to get seller access_token.

Query

Properties	Type	Description
app_key Required	string	Every single app will have a unique key. Please use the specific key assigned to your app.
sign Required	string	Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders.
timestamp Required	int	Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time.

Body

Properties	Type	Description
product_title Required	string	The product title. Title length:- DE, ES, FR, IE, IT, JP, UK, US: [1, 255] - MX:[1,300] - Other regions: [25, 255]
description	string	The product description in HTML format.Note:- The content must conform to the HTML syntax. All HTML tags are accepted but to optimize display on the TikTok Shop product detail page, the system will automatically convert certain tags into alternative formats, such as rendering tags as images.- Max length: 10,000 characters.- Image guidelines: You must use TikTok Shop image URLs. Max 30 tags, each under 4000px with src, width, and height attributes.Recommendations: - If you are syncing a pre-existing description from another platform, include the full HTML source description here.- Provide a detailed description, ideally over 300 characters.- Include 3-5 key selling points, each under 250 characters, with supporting images.- Use 1600x1600 px for the image dimensions. images []object Product images, including gallery images, images that appear in the description, product variant images. category_version string The category tree version to use for this product.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 Example CurlGoNode.jsJavaEnable word wrap Response Parameters Properties Type Description code int The success or failure status code returned in API response. message string The success or failure messages returned in API response. Reasons of failure will be described in the message. request_id string Request log data object Specific return information Example JSONEnable word wrap Error Code View common error codes | Code | Message | | --- | --- | | 12019006 | product description is invalid | | 12019009 | product image list is invalid | | 12019064 | No matching categories. Provide the full name of your product, edit its product properties, and try again. | | 12052013 | The product description cannot exceed maximum characters | | 12052051 | The product name exceed max limit characters | | 12052056 | The num of image in description cannot exceed max limit | | 12052217 | All region shops must use V2 categories. Check the documentation for further details. | | 12052230 | Category version and categoryID are not matched. | | 12052261 | product name is empty | | 12052262 | Chinese characters are not supported in product name | | 12052266 | The product name contains non-English characters. | | 12052301 | Width and length of main image must be at least {{min_limit}}, check uri {{uri}} | | 12052305 | The main images aspect ratio cannot exceed max limit. | | 12052306 | main product images count exceed limit | | 12052340 | product description image uri illegal | | 12052345 | The product description html tag not support. | | 12052346 | The product description has Chinese characters | | 12052348 | The product description html tag required attribute is miss. | | 12052349 | The product description html tag not support nest. | | 12052350 | The product description html tag contain illegal attribute. | | 12052351 | The product description contains non-English characters. | | 12052700 | The seller is inactive. | | 12052704 | seller id not exist | | 12052722 | The image URI does not exist in TikTok Shop. | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 12052912 | No matching category found within your account's main category. Check your main category in the seller profile on Seller Center and ensure your product falls within its scope. | | 12052931 | The title must follow these formatting rules: it cannot contain HTML escape characters (e.g.,  ), emojis, or ASCII control characters (e.g., \u007F). It also cannot consist solely of symbols (e.g., //// or !@#$$$&), nor can it have more than 9 consecutive repeated characters (e.g., aaaaaaaaa or 111111111). | | 12056001 | System error, try again later | Is this content helpful?Helpful Not Helpful PreviousNext