Get Bestselling Products

GET

/analytics/202511/products/bestselling

Returns up to 100 products ranked by GMV for the target date range.

Authorizations

• accessToken

Parameters

Query Parameters

shop_cipher

required

string

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

category_id

string

Filter products by a Level 1 category ID.

date

required

string format: date

The inclusive end date of the query period, in ISO 8601 YYYY-MM-DD format and the shop’s registered time zone. The period spans the selected time_slot and ends on this date (for example, 7D queries the seven days ending on this date). The date must be on or before the latest available date. If a request uses a later date, the error response identifies the latest available date; retry with that date or an earlier date.

time_slot

required

string

Allowed values: 1D 7D 30D

The length of the query period ending on date. Supported values are:

• 1D — 1 day
• 7D — 7 days
• 30D — 30 days

currency

string

Currency for monetary values. Use USD for US dollars or LOCAL for the local currency where the shop is registered. Default: LOCAL.

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

products

List of bestselling product records for the target date range.

Array<object>

object

rank

GMV rank of the product.

integer format: int64

gmv_range

GMV range of the product, in the currency specified by currency.

string

id

Product ID

string

name

Product name

string

rating

Product rating in history

string

product_image

Product image information, including URI, URLs, thumbnail URLs, height, and width.

object

height

The image height. Unit: px

integer format: int64

width

The image width. Unit: px

integer format: int64

thumb_urls

The URLs to view the image thumbnails.

Array<string>

uri

The URI of the image.

string

urls

The URLs to view the images.

Array<string>

shop_name

The TikTok Shop name.

string

shop_id

The ID of the TikTok Shop associated with the product.

string

Example

{
  "code": 0,
  "data": {
    "products": [
      {
        "rank": 1,
        "gmv_range": "$97000.00~$191000.00",
        "id": "123456",
        "name": "Labubu",
        "rating": "4.5",
        "product_image": {
          "height": 2000,
          "width": 2000,
          "thumb_urls": [
            "tos-useast5-i-omjb5zjo8w-tx/cad4b7c7409f459a87c54baf31ff8a20"
          ],
          "uri": "tos-useast5-i-omjb5zjo8w-tx/cad4b7c7409f459a87c54baf31ff8a20",
          "urls": [
            "https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/157d5bf9ac5a4af5855a2284626605c8~tplv-o3syd03w52-origin-jpeg.jpeg"
          ]
        },
        "shop_name": "Nia Batik",
        "shop_id": "7028916274713380866"
      }
    ]
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}