POST Search Responsible Persons
Search Responsible Persons Seller Required scope: seller.product.basic Retrieve a list of responsible persons in the EU languages supported by TikTok Shop based on their ID or keywords. When creating a product, pass the returned responsible_person_id to associate the product with the responsible person. Target seller: Local sellers operating in EU countries Version 202501
POST/product/202501/compliance/responsible_persons/search
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. |
| page_size Required | int | The number of results to be returned per page. Valid range: [1-100] |
| page_token | string | 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. |
Body
| Properties | Type | Description |
|---|---|---|
| responsible_person_ids | []string | Filter results by these responsible person IDs.Max IDs: The value of page_size |
| keyword | string | Filter results to show those that contain this keyword.Search scope: name, local_number, emailMax length: 200 charactersNote: Provide either the responsible_person_ids or keyword; if both are provided, responsible_person_ids will take priority. |
| locales | []string | The BCP-47 locale codes for displaying the responsible person information.Default: The locale of the seller's registered business address.Possible values:- de-DE- en-IE- es-ES- fr-FR- it-IT |
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 | | --- | --- | | 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 |
Is this content helpful?Helpful
Not Helpful
PreviousNext