Get Authorized Shops

GET

/authorization/202309/shops

Retrieves the list of shops that a seller has authorized for an app. Seller authorization is required before an app can access the data of a shop. Use this API to check which shops are currently authorized for an app and obtain the corresponding shop cipher for use as an input parameter in shop related APIs. For more information about seller authorization, refer to Seller authorization guide. Target seller: All

Authorizations

• accessToken

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

shops

The list of shops that a seller has authorized for the app.

Array<object>

object

id

An internal identifier for the TikTok Shop.

string

name

The TikTok Shop name.

string

region

The region of the shop.

string

seller_type

The type of seller. Possible values:

• CROSS_BORDER: Cross border sellers with multiple shops in different countries.
• LOCAL: Local sellers with only 1 shop.

string

Allowed values: CROSS_BORDER LOCAL

cipher

An encrypted token used to securely identify a shop in API requests. There is no need for decryption on the receiving end.

string

code

The TikTok Shop code, which is also displayed on Seller Center.

string

Example

{
  "code": 0,
  "data": {
    "shops": [
      {
        "id": "7000714532876273420",
        "name": "Maomao beauty shop",
        "region": "GB",
        "seller_type": "CROSS_BORDER",
        "cipher": "GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3",
        "code": "CNGBCBA4LLU8"
      }
    ]
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}