Sign in
Lives

Per-session creator LIVE-attributed GMV rows

Paginated per-session view of creator LIVE-attributed GMV for one shop — one row per affiliate LIVE session with creator, timestamps, GMV, units, and engagement.

Single-shop only. Defaults to the last 30 days ending today. Sort by live_gmv (default), start_time, units_sold or views. Empty sessions is a normal 200 response for shops without live-session data.

post/lives/list

Request body

start_datestring date nullable

Inclusive window start (YYYY-MM-DD). Defaults to 29 days before end_date.

end_datestring date nullable

Inclusive window end (YYYY-MM-DD). Defaults to today.

pageinteger
page_sizeinteger
sort_by'live_gmv' | 'start_time' | 'units_sold' | 'views'
sort_dir'asc' | 'desc'

Response

Successful Response

shop_idinteger required
currency_codestring nullable

ISO currency code for the window; null when empty or mixed.

start_datestring required
end_datestring required
pageinteger required
page_sizeinteger required
totalinteger required

Total number of affiliate LIVE sessions matching the window.

Changes

No recorded changes to this endpoint across all 1 revision of this API.