Search Responsible Persons

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

---

For common parameters, refer to How to call TikTok Shop APIs - Common Parameters

Default: The locale of the seller's registered business address. Possible values:

• de-DE
• en-IE
• es-ES
• fr-FR
• it-IT |

Query

https://open-api.tiktokglobalshop.com/product/202501/compliance/responsible_persons/search?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&page_size=10&page_token=66d3cbe4d9c8b09ddca932a7

Body

{"responsible_person_ids":["66d3cbe4d9c8b09ddca932a7"],"keyword":"John","locales":["en-IE","es-ES"]}

• de-DE
• en-IE
• es-ES
• fr-FR
• it-IT | ^^^name |string |John Doe |The responsible person name. Max length: 200 characters | ^^^email |string |john.doe@email.com |The email address of the responsible person. | ^^^phone_number |object | |The phone number of the responsible person. | ^^^^country_code |string |+353 |The country code of the phone number, prefixed by a plus + symbol. E.g. +353 for Ireland. Only EU country codes are allowed. Max digits: 4 | ^^^^local_number |string |80915151 |The local number. Length: 7 - 11 digits | ^^^address |object | |The residential address of the responsible person. | ^^^^street_address_line1 |string |63 Cardiff Ln, Grand Canal Dock, Dublin City, Dublin |The detailed street address of the location, including the building number, street name, district, city, province, and any relevant details. Max length: 500 characters | ^^^^street_address_line2 |string |- |(Deprecated: This field is deprecated and will return an empty string. Please refer to street_address_line1 instead for the relevant details.)

An optional secondary line for additional address details, if necessary. Max length: 500 characters | ^^^^district |string |- |(Deprecated: This field is deprecated and will return an empty string. Please refer to street_address_line1 instead for the district name.) The district name. Max length: 500 characters | ^^^^city |string |- |(Deprecated: This field is deprecated and will return an empty string. Please refer to street_address_line1 instead for the city name.) The city name. Max length: 500 characters | ^^^^postal_code |string |D02 HD23 |The postal code. Max length: 500 characters | ^^^^province |string |- |(Deprecated: This field is deprecated and will return an empty string. Please refer to street_address_line1 instead for the province name.) The province, state, or region name. Max length: 500 characters | ^^^^country |string |IE |The two letter ISO 3166 country code representing the country of the address. It must be an EU country. | ^total_count |int |26 |The number of responsible persons 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. |

{"code":0,"data":{"responsible_persons":[{"id":"66d3cbe4d9c8b09ddca932a7","regional_profiles":[{"locale":"en-IE","name":"John Doe","email":"john.doe@email.com","phone_number":{"country_code":"+353","local_number":"80915151"},"address":{"street_address_line1":"63 Cardiff Ln, Grand Canal Dock, Dublin City, Dublin","street_address_line2":"-","district":"-","city":"-","postal_code":"D02 HD23","province":"-","country":"IE"}}]}],"total_count":26,"next_page_token":"66d3cbe3d9c8b09ddca932a1"},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

For common error codes, refer to How to call TikTok Shop APIs - Common Error Code