Skip to content
TikTok Shop Partner API

Get Shop LIVE Performance List

GET
/analytics/202609/shop_lives/performance

Returns a list of LIVE stream sessions and associated metrics for a shop. Sellers can only query room ID data for their own official creator accounts.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
shop_cipher
required
string

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

start_date_ge
required
string format: date

Start date (ISO 8601 YYYY-MM-DD format) in shop registered timezone. In the parameter name, “ge” refers to “greater than or equal to” (inclusive)

end_date_lt
required
string format: date

End date (ISO 8601 YYYY-MM-DD format) in shop registered timezone. In the parameter name, “lt” refers to “less than” (exclusive)

account_type
required
string
Allowed values: OFFICIAL_ACCOUNTS MARKETING_ACCOUNTS AFFILIATE_ACCOUNTS

Types of the accounts under which videos were created. Available values:

  • OFFICIAL_ACCOUNTS: Official accounts.
  • MARKETING_ACCOUNTS: Marketing accounts.
  • AFFILIATE_ACCOUNTS: Affiliate accounts.
page_size
integer format: int64
<= 100

Number of products per page. Max value: 100 Default value: 10

sort_field
string
Allowed values: live_attributed_gmv products_added products_sold live_attributed_sku_orders live_attributed_items_sold attributed_customers

Field to sort on. Default: live_attributed_gmv Available values:

  • live_attributed_gmv
  • products_added
  • products_sold
  • live_attributed_sku_orders
  • live_attributed_items_sold
  • attributed_customers
sort_order
string
Allowed values: ASC DESC

Sort direction. Available values:

  • ASC: Ascending order.
  • DESC: Descending order. Default value: DESC
currency
string
Allowed values: USD LOCAL

Currency. Available values:

  • USD: US dollars.
  • LOCAL: Local currency where the shop is located. Default value: LOCAL
page_token
string

Page token, indicating the current position. Used for requesting next page data. Leave this field empty for first time queries.

Responses

Section titled “Responses”

200

Section titled “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
latest_available_date

Latest date in local timezone where data is ready (ISO 8601 format).

string format: date
live_stream_sessions

List of live performance metrics.

Array<object>
object
creator

Creator information for the LIVE session.

object
author_type

The creator account type.

string
creator_country

The creator’s country or region code.

string
nick_name

The creator’s nickname.

string
open_id

The creator’s Open ID.

string
user_name

The creator’s username.

string
end_time

End time of the LIVE, unix timestamp GMT (UTC+00:00).

string
id

ID of the LIVE

string
interaction_performance

This object will return only when the account type is:

  • OFFICIAL_ACCOUNTS:
  • MARKETING_ACCOUNTS
object
comment_rate

Ratio of comments to views. Expressed as a raw decimal string.

string
comments

Number of comments on the LIVE video posted during the selected period.

integer format: int64
follow_rate

Ratio of new followers to viewers. Expressed as a raw decimal string.

string
like_rate

Ratio of likes to views. Expressed as a raw decimal string.

string
likes

The number of likes a LIVE video received during the selected time period.

integer format: int64
new_followers

The number of viewers who followed creators from the video during the selected period.

integer format: int64
share_rate

Ratio of shares to views. Expressed as a raw decimal string.

string
shares

Number of times the LIVE video posted during the selected period were shared.

integer format: int64
sales_performance

Sale performance data of the LIVE related to the shop

object
aov

Average order value for the LIVE session.

object
amount

Amount in the corresponding currency.

string
currency

Currency code (ISO 4217 standard).

string
attributed_customers

Number of customers attributed to the LIVE session.

integer format: int64
avg_live_auction_price

Average price per item sold for LIVE auction products.

object
amount

Amount in the corresponding currency.

string
currency

Currency code (ISO 4217 standard).

string
avg_price

The total price paid for all items divided by the number of items sold.

object
amount

GMV amount in the corresponding currency.

string
currency

GMV currency code (ISO 4217 standard). If LOCAL currency is requested, the value will be the local currency code of where the shop is registered (e.g. GBP).

string
created_sku_orders

The total number of orders created during the selected period, including those with pending payment for cash-on-delivery or PayLater. Example: If a customer orders 3 units of SKU A and 2 units of SKU B, the SKU orders would be 2.

integer format: int64
gmv_with_tiktok_coupons

GMV including TikTok coupon funding.

object
amount

Amount in the corresponding currency.

string
currency

Currency code (ISO 4217 standard).

string
live_attributed_gmv

GMV attributed to the LIVE session.

object
amount

Amount in the corresponding currency.

string
currency

Currency code (ISO 4217 standard).

string
live_attributed_items_sold

Number of items sold attributed to the LIVE session.

integer format: int64
live_attributed_orders

Number of orders attributed to the LIVE session.

integer format: int64
live_attributed_sku_orders

Number of paid SKU orders attributed to the LIVE session.

integer format: int64
live_auction_attributed_gmv

GMV attributed to LIVE auction products.

object
amount

Amount in the corresponding currency.

string
currency

Currency code (ISO 4217 standard).

string
live_auction_attributed_items_sold

Number of items sold attributed to LIVE auction products.

integer format: int64
live_auction_attributed_sku_orders

Number of paid SKU orders attributed to LIVE auction products.

integer format: int64
live_auction_gmv

Direct GMV generated from LIVE auction products.

object
amount

Amount in the corresponding currency.

string
currency

Currency code (ISO 4217 standard).

string
live_auction_indirect_gmv

Indirect GMV generated from LIVE auction products.

object
amount

Amount in the corresponding currency.

string
currency

Currency code (ISO 4217 standard).

string
live_gmv

Direct GMV generated from the LIVE session.

object
amount

Amount in the corresponding currency.

string
currency

Currency code (ISO 4217 standard).

string
live_indirect_gmv

Indirect GMV generated from the LIVE session.

object
amount

Amount in the corresponding currency.

string
currency

Currency code (ISO 4217 standard).

string
payment_rate

Ratio of paid orders to created orders. Expressed as a raw decimal string.

string
products_sold

Number of distinct products sold from the LIVE session.

integer format: int64
start_time

Start time of the LIVE, unix timestamp GMT (UTC+00:00).

string
title

Title of the LIVE

string
traffic

Traffic efficiency metrics for the LIVE session.

object
acu

Average concurrent users.

integer format: int64
avg_viewing_duration

Average viewing duration in seconds.

integer format: int64
avg_viewing_duration_per_viewer

Average viewing duration per viewer in seconds.

integer format: int64
ctor

Click-to-order rate. Expressed as a raw decimal string.

string
ctor_sku_order

Ratio of attributed SKU orders to product clicks. Expressed as a raw decimal string.

string
ctr

Click-through rate. Expressed as a raw decimal string.

string
gmv_per_hour

LIVE-attributed GMV generated per hour.

object
amount

Amount in the corresponding currency.

string
currency

Currency code (ISO 4217 standard).

string
impressions

Number of LIVE impressions.

integer format: int64
impressions_per_hour

Average number of impressions per hour.

integer format: int64
live_ctr

Ratio of product clicks to product impressions. Expressed as a raw decimal string.

string
order_rate_sku_orders

Ratio of attributed SKU orders to views. Expressed as a raw decimal string.

string
over_1m_live_viewing_rate

Ratio of views lasting longer than one minute. Expressed as a raw decimal string.

string
over_1m_views

Number of views lasting longer than one minute.

integer format: int64
pcu

Peak concurrent users.

integer format: int64
product_clicks

Number of product clicks.

integer format: int64
product_impressions

Number of product impressions.

integer format: int64
products_added

Number of products added to the LIVE session.

integer format: int64
show_gpm

LIVE-attributed GMV generated per 1,000 impressions.

object
amount

Amount in the corresponding currency.

string
currency

Currency code (ISO 4217 standard).

string
tap_through_rate

Ratio of LIVE views to LIVE impressions. Expressed as a raw decimal string.

string
viewers

Number of unique viewers.

integer format: int64
views

Number of LIVE views.

integer format: int64
watch_gpm

LIVE-attributed GMV generated per 1,000 watch units.

object
amount

Amount in the corresponding currency.

string
currency

Currency code (ISO 4217 standard).

string
next_page_token

Page token for the next page request.

string
total_count

Total number of LIVE stream sessions.

integer format: int64
updated_at

Time when the data was last updated in shop registered timezone.

string
Example
{
  "code": 0,
  "data": {
    "latest_available_date": "2024-09-07",
    "live_stream_sessions": [
      {
        "creator": {
          "author_type": "OFFICIAL",
          "creator_country": "US",
          "nick_name": "abc_bec",
          "open_id": "uACafQAAAABmUU2qon4R0vUYvUVS3QC6CICP2m5A2-wd77j8R9G0yg",
          "user_name": "creator_shop_01"
        },
        "end_time": "1623812864",
        "id": "75xxxxxxxxxxxxxxx28",
        "interaction_performance": {
          "comment_rate": "0.0047",
          "comments": 534,
          "follow_rate": "0.0007",
          "like_rate": "0.0216",
          "likes": 2442,
          "new_followers": 12,
          "share_rate": "0.0014",
          "shares": 156
        },
        "sales_performance": {
          "aov": {
            "amount": "19.80",
            "currency": "USD"
          },
          "attributed_customers": 50,
          "avg_live_auction_price": {
            "amount": "0.00",
            "currency": "USD"
          },
          "avg_price": {
            "amount": "9",
            "currency": "USD"
          },
          "created_sku_orders": 100,
          "gmv_with_tiktok_coupons": {
            "amount": "105.00",
            "currency": "USD"
          },
          "live_attributed_gmv": {
            "amount": "99.00",
            "currency": "USD"
          },
          "live_attributed_items_sold": 122,
          "live_attributed_orders": 60,
          "live_attributed_sku_orders": 80,
          "live_auction_attributed_gmv": {
            "amount": "0.00",
            "currency": "USD"
          },
          "live_auction_attributed_items_sold": 0,
          "live_auction_attributed_sku_orders": 0,
          "live_auction_gmv": {
            "amount": "0.00",
            "currency": "USD"
          },
          "live_auction_indirect_gmv": {
            "amount": "0.00",
            "currency": "USD"
          },
          "live_gmv": {
            "amount": "99.00",
            "currency": "USD"
          },
          "live_indirect_gmv": {
            "amount": "0.00",
            "currency": "USD"
          },
          "payment_rate": "0.8000",
          "products_sold": 5
        },
        "start_time": "1623812664",
        "title": "abxxxxx",
        "traffic": {
          "acu": 123,
          "avg_viewing_duration": 46,
          "avg_viewing_duration_per_viewer": 284,
          "ctor": "0.0129",
          "ctor_sku_order": "0.0206",
          "ctr": "0.0290",
          "gmv_per_hour": {
            "amount": "49.50",
            "currency": "USD"
          },
          "impressions": 130000,
          "impressions_per_hour": 65000,
          "live_ctr": "0.1399",
          "order_rate_sku_orders": "0.0044",
          "over_1m_live_viewing_rate": "0.1774",
          "over_1m_views": 3250,
          "pcu": 1332,
          "product_clicks": 3882,
          "product_impressions": 27749,
          "products_added": 12,
          "show_gpm": {
            "amount": "0.76",
            "currency": "USD"
          },
          "tap_through_rate": "0.8692",
          "viewers": 18323,
          "views": 112993,
          "watch_gpm": {
            "amount": "0.88",
            "currency": "USD"
          }
        }
      }
    ],
    "next_page_token": "cGFnZV9udW1iZXI9MQ==",
    "total_count": 233,
    "updated_at": "2026-09-02 21:52:00"
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}
DocsSDKsAPI Reference

Start here

Getting StartedConceptsAuthorizationWebhooksErrors

SDKs

Choose an SDK

OpenAPI

The spec