Get Brands

GET

/product/202309/brands

Retrieve brands for your shop, including the built-in brands and any custom brands created using the Create Custom Brands API. Pass the returned brand ID when creating or editing a product to associate the brand with the product.

• To check if a brand is fully authorized for use in a specific product category, specify the category ID.
• To obtain the full list of brands that your shop can potentially use and their authorization status, omit the category ID. We recommend that you specify the brand name to narrow down the list of brands returned. Key concept Whether you can select and display a brand depends on the brand’s authorization status, the categories authorized for the brand, and whether the brand is classified as T1 (internationally renowned brands that require prior brand authorization). - Brand selection rules: You can only select the following types of brands during product creation/editing.
  • Authorized brands which contain the desired category (authorized_status=AUTHORIZED and brand_status=AVAILABLE)
  • Unauthorized non-T1 brands (authorized_status=UNAUTHORIEZD and is_t1_brand=false) - Brand display rules: Note however that brands will only appear on the product display page if the brand is authorized (authorized_status=AUTHORIZED) and available in the desired category (brand_status=AVAILABLE). This means that you need to obtain brand authorization for unauthorized non-T1 brands before they can be displayed. Obtain brand authorization or add categories to an authorized brand through TikTok Shop Seller Center > Qualification Center > Brand qualification. For Tokopedia sellers: You can select and display any returned brand on Tokopedia regardless of these rules.

Authorizations

• accessToken

Parameters

Query Parameters

shop_cipher

required

string

Identifies the shop. Obtain it from the Get Authorized Shops API.

category_id

string

Specify a category ID to show the availability of authorized brands in the category. Note: Specify this value to obtain an accurate list of brands that you can use in a category.

is_authorized

boolean

Filter results by the brand authorization status. Possible values:

• 1: Returns only authorized brands
• 0: Returns all brands

brand_name

string

Filter results to include brand names that begin with the specified value.

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.

category_version

string

Filter categories by the category tree version.Possible values based on region:

• US, EU and SEA: v2, represents the 7-level category tree. Important: For US, EU and SEA shops, you must pass v2 when using this API.
• Other regions: v1, represents the 3-level category tree.Default: v1

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

brands

The list of brands that meet the query conditions.

Array<object>

object

id

The brand ID.

string

name

The brand name.

string

authorized_status

A status to indicate whether the seller has obtained prior authorization to sell goods bearing the brand’s trademark, name, or logo. Possible values:

• UNAUTHORIEZD
• AUTHORIZED

Note: If the brand is unauthorized, check is_t1_brand to determine if you can use it during product creation.

string

Allowed values: UNAUTHORIEZD AUTHORIZED

is_t1_brand

A flag to indicate whether the brand is a T1 brand, which refers to internationally renowned brands that may have compliance risks and require sellers to obtain brand authorization.

Note:

• You cannot create products with unauthorized T1 brands.
• You can create products with unauthorized non-T1 brands, but the brand information will not appear on the product display page. You can obtain authorization by submitting the required qualifications through TikTok Shop Seller Center > Qualification Center > Brand qualification.

boolean

brand_status

The availability of an authorized brand in the requested category. Possible values:

• AVAILABLE
• UNAVAILABLE

Note: Not applicable if you did not specify the category ID, or the brand is unauthorized.

string

Allowed values: AVAILABLE UNAVAILABLE

total_count

The total count of brands 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. If this value is non-empty, pass it in the page_token parameter of the next request. An empty value means there are no more results.

string

Example

{
  "code": 0,
  "data": {
    "brands": [
      {
        "id": "7082427311584347905",
        "name": "Teas",
        "authorized_status": "AUTHORIZED",
        "is_t1_brand": true,
        "brand_status": "AVAILABLE"
      }
    ],
    "total_count": 10000,
    "next_page_token": "cGFnZV9udW1iZXI9Mg=="
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}