来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存,可追溯
- 官方原文可核对
资料正文
§1 Path: /product/202601/compliance/auditing/research
#§2 Method: [POST]
#§3 Function Description
For compliant vendor to rescan all of the product information so that the compliant vendor can issue a compliance testing report.
§4 Common Parameters
For common parameters, refer to How to call TikTok Shop APIs - Common Parameters
| Properties | Location | Type | Require | Sample | Properties description |
|---|---|---|---|---|---|
| content-type | header | string | Y | application/json | Allowed type: application/json |
§5 Request Query Parameters
| Properties | Type | Require | Sample | Properties description |
|---|---|---|---|---|
| shop_cipher | string | N | GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3 | Use this property to pass shop information in requesting the API. Failure in passing the correct value when requesting the API for cross-border shops will return incorrect response. |
| Get by API Get Authorization Shop | ||||
| category_asset_cipher | string | N | GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3 | Use this property to pass shop information in requesting the API. Failure in passing the correct value when requesting the API for cross-border shops will return The partner identifier used in API requests. |
| Retrieve this value by using the Get Authorized Category Assets API. | ||||
| app_key | string | Y | 38abcd | Every single app will have a unique key. Please use the specific key assigned to your app. |
| sign | string | Y | 5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c | Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders. |
| timestamp | int | Y | 1623812664 | Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time. |
| page_token | string | N | ["1733419489460520284"] | returned by the current page, and for the first page, it is an empty string. |
| page_size | int | Y | 20 | The number of results to be returned per page. |
| Valid range: [1-50] |
§6 Request Body Parameters
| Properties | Type | Require | Sample | Properties description |
|---|---|---|---|---|
| product_title | string | N | mike noritama cute calico cat | The product title. |
| Title length: |
- DE, ES, FR, IE, IT, JP, UK, US: [1, 255]
- BR, MX: [1, 300]
- Other regions: [25, 255] | product_ids |[]string |N |["123123","1235677","456756"] |The product ID generated by TikTok Shop. Max is 20 | seller_id |string |N |1733337095719126364 |The Shop identity ID. | category_ids |[]string |N |["602118"] |The category id of the source product included in the virtual bundle. | brand_ids |[]string |N |["602118"] |The ID of the brand of this product. | seller_name |string |N |shopname1 |The name of the shop which product belongs to. |
§7 Request Sample
Query
https://open-api.tiktokglobalshop.com/product/202601/compliance/auditing/research?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c×tamp=1625484268&page_token=[\"1733419489460520284\"]&page_size=20
Body
{"product_title":"mike noritama cute calico cat","product_ids":["123123","1235677","456756"],"seller_id":"1733337095719126364","category_ids":["602118"],"brand_ids":["602118"],"seller_name":"shopname1"}
§8 Response Parameters
| Properties | Type | Sample | Properties description |
|---|---|---|---|
| code | int | 0 | The success or failure status code returned in API response. |
| message | string | Success | The success or failure messages returned in API response. Reasons of failure will be described in the message. |
| request_id | string | 202203070749000101890810281E8C70B7 | Request log |
| data | object | Specific return information | |
| ^next_page_token | string | ["1733419489460520284"] | Obtain the transmission parameters for the next page data |
| ^total_count | int | 454 | The total count of product in the search filter. |
| ^products | []object | Product information | |
| ^^id | string | 1729592969712207008 | The product ID generated by TikTok Shop. |
| ^^title | string | mike noritama cute calico cat | The product title. |
| Title length: |
- DE, ES, FR, IE, IT, JP, UK, US: [1, 255]
- BR, MX: [1, 300]
- Other regions: [25, 255] | ^^country |string |FR |The regions where the product is sold. Possible values:
- BR: Brazil
- DE: Germany
- ES: Spain
- FR: France
- GB: United Kingdom
- ID: Indonesia
- IE: Ireland
- IT: Italy
- JP: Japan
- MX: Mexico
- MY: Malaysia
- PH: Philippines
- SG: Singapore
- TH: Thailand
- US: United States
- VN: Vietnam | ^^description |string | Please compare above detailed size with your measurement before purchase.
- M-Size
- XL-Size
Image |The product description in HTML format. | ^^variants |[]object | |A list of Stock Keeping Units (SKUs) used to identify distinct variants of the product. | ^^^id |string |11111 |The SKU ID generated by TikTok Shop. | ^^listing_url |string |https://shop.tiktok.com/view/product/1733990243784295749?region=FR |The product detail page URL of the product. | ^^seller_name |string |Essential Shop |The name of the shop which product belongs to. | ^^seller_id |string |11111 |The Shop identity ID. | ^^main_image_urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |The URLs to view the images. | ^^brand_id |string |1111 |The ID of the brand of this product. | ^^brand_name |string |Labor |The brand name. | ^^categories |[]object | |The category tree information of the source product included in the virtual bundle. | ^^^id |string |1111 |The ID of the category of this product. | ^^^name |string |Kostum |The name of the category in the country where the shop operates. | ^^^level |int |1 |The level of the category in the country where the shop operates. | ^^^parent_id |string |1111 |The parent category ID. For the root category, the parent ID is 0 | ^^^is_leaf |bool |false |A flag to indicate if the category is a leaf category. Note: You can only create or edit products that belong to a leaf category. |
§9 Response Sample
{"code":0,"data":{"next_page_token":"[\\\"1733419489460520284\\\"]","total_count":454,"products":[{"id":"1729592969712207008","title":"mike noritama cute calico cat","country":"FR","description":"\u003cp\u003ePlease compare above detailed size with your measurement before purchase.\u003c/p\u003e\n\u003cul\u003e \n \u003cli\u003eM-Size\u003c/li\u003e\n \u003cli\u003eXL-Size\u003c/li\u003e\n\u003c/ul\u003e \n\u003cimg src=\"https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/181595ea7d26489284b5667488d708c1~tplv-o3syd03w52-origin-jpeg.jpeg?from=1432613627\" /\u003e\n","variants":[{"id":"11111"}],"listing_url":"https://shop.tiktok.com/view/product/1733990243784295749?region=FR","seller_name":"Essential Shop","seller_id":"11111","main_image_urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"brand_id":"1111","brand_name":"Labor","categories":[{"id":"1111","name":"Kostum","level":1,"parent_id":"1111","is_leaf":false}]}]},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}
§10 Error Code
For common error codes, refer to How to call TikTok Shop APIs - Common Error Code
| Code | Message |
|---|---|
| 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. |
