Get Bestselling Videos

GET

/analytics/202511/videos/bestselling

Returns up to 100 videos ranked by gross merchandise value (GMV) in descending order for the date range selected by date and time_slot.

Authorizations

• accessToken

Parameters

Query Parameters

shop_cipher

required

string

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

date

required

string format: date

The reference date (ISO 8601 YYYY-MM-DD format) in the shop’s registered timezone. The query calculates data backwards from this date based on time_slot (for example, 7D returns data for the 7 days ending on this date). This date is inclusive and must be on or before the latest available data 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. If omitted, the default is 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

videos

List of bestselling video records for the target date range.

Array<object>

object

rank

Gmv rank of the video

integer format: int64

id

Video id

string

nick_name

Creator handle

string

gmv_range

Gmv range of the video

string

views

Accumulative number of video views since the video was published.

integer format: int64

likes

Accumulative number of video likes since the video was published.

integer format: int64

comments

Accumulative number of video comments since the video was published.

integer format: int64

shares

Accumulative number of video shares since the video was published.

integer format: int64

product_infos

List of product anchors associated with the video, including product IDs and product names. Excludes deactivated and sold-out products.

Array<object>

object

product_id

Product ID in the product anchor. Excludes deactivated and sold-out products.

string

product_name

Product name in the product anchor. Deactivated and sold-out products are excluded.

string

publish_time

The time when the video was published, as a Unix timestamp in seconds (UTC).

integer format: int64

duration

Duration of the video, in seconds.

integer format: int64

Example

{
  "code": 0,
  "data": {
    "videos": [
      {
        "rank": 1,
        "id": "10484583",
        "nick_name": "abc_bec",
        "gmv_range": "$97000.00~$191000.00",
        "views": 939829,
        "likes": 83894,
        "comments": 1934,
        "shares": 223,
        "product_infos": [
          {
            "product_id": "1731736614984386107",
            "product_name": "labubu"
          }
        ],
        "publish_time": 1623812664,
        "duration": 7602
      }
    ]
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}