来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Summary
#§2 What is changing
What is changing
The Recommend Category API now accepts five new optional request fields that allow developers to provide product information from the source platform:
origin_platform_product_typeorigin_platform_vendororigin_platform_tagsorigin_platform_categoryorigin_platform_product_meta_data
§3 Why this is changing
Why this is changing
This update allows catalog synchronization and cross-platform listing integrations to include additional source-platform context when requesting a TikTok Shop category recommendation.
§4 Impact
Impact
This is an additive request-schema update. Existing integrations can continue using their current request payloads. Developers who choose to send the new fields should update their request models and serializers to support the documented nested objects and arrays.
§5 API Impact
#§6 Scope of change
Scope of change
| API | Change type | External impact |
|---|---|---|
| Recommend Category | Request payload update | Adds optional request properties for source-platform product type, vendor or brand name, tags, category information, and additional product metadata. |
Endpoint: POST /product/202309/categories/recommend
§7 New optional request parameters
New optional request parameters
| Parameter | Type | Description |
|---|---|---|
origin_platform_product_type | string | The product type defined on the source platform. |
origin_platform_vendor | string | The product vendor or brand name on the source platform. |
origin_platform_tags | string[] | Tags associated with the product on the source platform. |
origin_platform_category | object | Category information assigned to the product on the source platform. |
origin_platform_category.id | string | The category ID on the source platform. |
origin_platform_category.name | string | The category name on the source platform. |
origin_platform_category.full_name | string | The full category path or full category name on the source platform. |
origin_platform_category.is_leaf | bool | Whether the category is a leaf category. |
origin_platform_category.is_root | bool | Whether the category is a root category. |
origin_platform_product_meta_data | object | Additional product metadata provided by the source platform. |
origin_platform_product_meta_data.attribute_value_list | object[] | A list of product metadata attributes and their values. |
origin_platform_product_meta_data.attribute_value_list[].name | string | The metadata attribute name. |
origin_platform_product_meta_data.attribute_value_list[].values | string[] | The values associated with the metadata attribute. |
§8 Behavior change
Behavior change
- All five top-level properties and their nested properties are optional.
origin_platform_categorycan include the source category identifier, name, full category path, and leaf or root indicators.origin_platform_product_meta_data.attribute_value_listcan include multiple metadata attributes, each with one or more string values.- Current request payloads remain valid when the new fields are omitted.
§9 Developer Action Items
For integrations that synchronize product catalogs from another platform:
- Update request models and serializers if you plan to send source-platform product context.
- Preserve the exact property names, nesting, and array types.
- Map source-platform category and metadata values to the corresponding request fields.
- Add request-serialization and integration tests covering the new fields.
For integrations that do not use source-platform product context, no action is required.
§10 Changelog Summary
Recommend Category now accepts optional source-platform product context in its request payload. Existing request flows remain unchanged when these fields are omitted.