stable本次发布有变化全部展示
来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存,可追溯
- 官方原文可核对
资料正文
§1 Path: /product/202501/compliance/manufacturers/search
#§2 Method: [POST]
#§3 Function Description
Retrieve a list of manufacturers in the EU languages supported by TikTok Shop based on their IDs or keyword.
When creating a product, pass the returned manufacturer_id to associate the product with the manufacturer.
Target seller: Local sellers operating in EU countries
§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 |
|---|---|---|---|---|
| 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_size | int | Y | 10 | The number of results to be returned per page. |
| Valid range: [1-100] | ||||
| page_token | string | N | 66d3cbe4d9c8b09ddca932a7 | An opaque token used to retrieve the next page of a paginated result set. Retrieve this value from the result of the next_page_token from a previous response. It is not needed for the first page. |
§6 Request Body Parameters
| Properties | Type | Require | Sample | Properties description |
|---|---|---|---|---|
| manufacturer_ids | []string | N | ["66d3cbe4d9c8b09ddca932a7"] | Filter results by these manufacturer IDs. |
Max IDs: The value of page_size | ||||
| keyword | string | N | John | Filter results to show those that contain this keyword. |
| Search scope: name, registered trade name, local_number, email | ||||
| Max length: 200 characters | ||||
Note: Provide either the manufacturer_ids or keyword; if both are provided, manufacturer_ids will take priority. | ||||
| locales | []string | N | ["en-IE", "es-ES"] | The BCP-47 locale codes for displaying the manufacturer information. |
Default: The locale of the seller's registered business address. Possible values:
- de-DE
- en-IE
- es-ES
- fr-FR
- it-IT |
§7 Request Sample
Query
https://open-api.tiktokglobalshop.com/product/202501/compliance/manufacturers/search?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c×tamp=1625484268&page_size=10&page_token=66d3cbe4d9c8b09ddca932a7
Body
{"manufacturer_ids":["66d3cbe4d9c8b09ddca932a7"],"keyword":"John","locales":["en-IE","es-ES"]}
§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 | |
| ^manufacturers | []object | The list of manufacturers that meet the query conditions. | |
| ^^id | string | 66d3cbe4d9c8b09ddca932a7 | The manufacturer ID in TikTok Shop. |
| ^^regional_profiles | []object | A list of contact details for the manufacturer, presented in different languages for each supported EU country. | |
| ^^^locale | string | en-IE | The BCP-47 locale code representing the language used for specifying the manufacturer information. |
| Possible values: |
- de-DE
- en-IE
- es-ES
- fr-FR
- it-IT | ^^^name |string |John Doe |The manufacturer name. Max length: 255 characters | ^^^registered_trade_name |string |TikTok Shop |The registered trade name of the manufacturer. Max length: 200 characters | ^^^email |string |johndoe@email.com |The email address of the manufacturer. | ^^^phone_number |object | |The phone number of the manufacturer. | ^^^^availability |string |AVAILABLE |Indicates the availability of the phone number. Possible values:
AVAILABLE: The phone number is available and required.UNAVAILABLE: No phone number is available. | ^^^^country_code |string |+353 |The country code of the phone number, prefixed by a plus+symbol. E.g. +353 for Ireland. Max digits: 4 Required ifavailability=AVAILABLE. | ^^^^local_number |string |81234567 |The local number. Length: 7 - 20 digits Required ifavailability=AVAILABLE. | ^^^address |string |10 Earlsfort Terrace, Dublin, Ireland |The postal address of the manufacturer. Max length: 500 characters | ^total_count |int |26 |The number of manufacturers that meet the query conditions. | ^next_page_token |string |66d3cbe3d9c8b09ddca932a1 |An opaque token used to retrieve the next page of a paginated result set. Provide this value in thepage_tokenparameter of your request if the current response does not return all the results. |
§9 Response Sample
{"code":0,"data":{"manufacturers":[{"id":"66d3cbe4d9c8b09ddca932a7","regional_profiles":[{"locale":"en-IE","name":"John Doe","registered_trade_name":"TikTok Shop","email":"johndoe@email.com","phone_number":{"availability":"AVAILABLE","country_code":"+353","local_number":"81234567"},"address":"10 Earlsfort Terrace, Dublin, Ireland"}]}],"total_count":26,"next_page_token":"66d3cbe3d9c8b09ddca932a1"},"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 |
|---|---|
| 38023025 | Internal error |
| 38023047 | Invalid page size |
| 38023048 | Invalid page token |
| 38023049 | The number of ids is larger than page size |
| 38023050 | Operation is not supported for global seller |
| 38023057 | Unsupported locale |
| 38023060 | Invalid phone number availability. Supported values: AVAILABLE, UNAVAILABLE |
