Get Brands

Retrieve all available 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=UNAUTHORIZED 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.

---

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

• 1: Returns only authorized brands
• 0: Returns all brands | brand_name |string |N |Teas |Filter results to include brand names that begin with the specified value. | page_size |int |Y |100 |The number of results to be returned per page. Valid range: [1-100] | page_token |string |N |b2Zmc2V0PTAK |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 |N |v1 |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 |

Query

https://open-api.tiktokglobalshop.com/product/202309/brands?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&shop_cipher=ROW_RHkDDABBAAB8tKAVoAqsMTjsQZFLyNfY&category_id=600006&is_authorized=false&brand_name=Teas&page_size=100&page_token=b2Zmc2V0PTAK&category_version=v1

• UNAUTHORIEZD
• AUTHORIZED

Note: If the brand is unauthorized, check is_t1_brand to determine if you can use it during product creation. | ^^is_t1_brand |bool |true |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. | ^^brand_status |string |AVAILABLE |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. | ^total_count |int |10000 |The total count of brands that meet the query conditions. | ^next_page_token |string |b2Zmc2V0PTAK |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":{"brands":[{"id":"7082427311584347905","name":"Teas","authorized_status":"AUTHORIZED","is_t1_brand":true,"brand_status":"AVAILABLE"}],"total_count":10000,"next_page_token":"b2Zmc2V0PTAK"},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

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