Search Manufacturers

POST

/product/202501/compliance/manufacturers/search

Retrieve a list of manufacturers in the EU languages supported by TikTok Shop based on their IDs or keyword. When creating a product with the Create Product API, pass a returned manufacturer’s id as an element of manufacturer_ids. Target seller: Local sellers operating in EU countries

Authorizations

• accessToken

Parameters

Query Parameters

page_size

required

integer format: int64

>= 1 <= 100

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.

Request Body

Media typeapplication/json

object

manufacturer_ids

Filter results by these manufacturer IDs. Max IDs: The value of page_size

Array<string>

keyword

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.

string

<= 200 characters

locales

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

Array<string>

Allowed values: de-DE en-IE es-ES fr-FR it-IT

Example

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

Responses

200

Success

Media typeapplication/json

object

code

Status code; 0 means success.

integer format: int64

message

Success or failure message.

string

request_id

Request log ID.

string

data

object

manufacturers

The list of manufacturers that meet the query conditions.

Array<object>

object

id

The manufacturer ID in TikTok Shop.

string

regional_profiles

A list of contact details for the manufacturer, presented in different languages for each supported EU country.

Array<object>

object

locale

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

string

Allowed values: de-DE en-IE es-ES fr-FR it-IT

name

The manufacturer name. Max length: 255 characters

string

<= 255 characters

registered_trade_name

The registered trade name of the manufacturer. Max length: 200 characters

string

<= 200 characters

email

The email address of the manufacturer.

string

phone_number

The phone number of the manufacturer.

object

availability

Indicates the availability of the phone number. Possible values:

• AVAILABLE: The phone number is available and required.
• UNAVAILABLE: No phone number is available.

Default: AVAILABLE

string

Allowed values: AVAILABLE UNAVAILABLE

country_code

The country code of the phone number, prefixed by a plus + symbol. E.g. +353 for Ireland. Max digits: 4 Required if availability=AVAILABLE.

string

local_number

The local number. Length: 7 - 20 digits Required if availability=AVAILABLE.

string

address

The postal address of the manufacturer. Max length: 500 characters

string

<= 500 characters

total_count

The number of manufacturers that meet the query conditions.

integer format: int64

next_page_token

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.

string

Example

{
  "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"
}