快工助手跨境电商知识与商机助手

Search Manufacturers

TikTok Shop 官方资料 · TikTok Shop Partner Center 开发者文档 · 适合开发者

stable本次发布有变化全部展示

来自 TikTok Shop 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
TikTok Shop / profile.tiktok.docs_api
语言
en-US
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/tiktok_shopaudience/developercategory/api_doctopic/compliancetopic/developer

资料正文

§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-typeheaderstringYapplication/jsonAllowed type: application/json
#

§5 Request Query Parameters

Properties Type Require Sample Properties description
app_keystringY38abcdEvery single app will have a unique key. Please use the specific key assigned to your app.
signstringY5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8cSignature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders.
timestampintY1623812664Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time.
page_sizeintY10The number of results to be returned per page.
Valid range: [1-100]
page_tokenstringN66d3cbe4d9c8b09ddca932a7An 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[]stringN["66d3cbe4d9c8b09ddca932a7"]Filter results by these manufacturer IDs.
Max IDs: The value of page_size
keywordstringNJohnFilter 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[]stringN["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&timestamp=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
codeint0The success or failure status code returned in API response.
messagestringSuccessThe success or failure messages returned in API response. Reasons of failure will be described in the message.
request_idstring202203070749000101890810281E8C70B7Request log
dataobjectSpecific return information
^manufacturers[]objectThe list of manufacturers that meet the query conditions.
^^idstring66d3cbe4d9c8b09ddca932a7The manufacturer ID in TikTok Shop.
^^regional_profiles[]objectA list of contact details for the manufacturer, presented in different languages for each supported EU country.
^^^localestringen-IEThe 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 if availability=AVAILABLE. | ^^^^local_number |string |81234567 |The local number. Length: 7 - 20 digits Required if availability=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 the page_token parameter 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
38023025Internal error
38023047Invalid page size
38023048Invalid page token
38023049The number of ids is larger than page size
38023050Operation is not supported for global seller
38023057Unsupported locale
38023060Invalid phone number availability. Supported values: AVAILABLE, UNAVAILABLE
#