cURL
curl --request GET \
--url 'https://api.keyapi.ai/v1/tiktok/shop/livestreams/analytics' \
--header 'Authorization: Bearer <YOUR_API_KEY>'import requests
response = requests.get(
'https://api.keyapi.ai/v1/tiktok/shop/livestreams/analytics',
params={},
headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
)
print(response.json())const response = await fetch('https://api.keyapi.ai/v1/tiktok/shop/livestreams/analytics',
{
method: 'GET',
headers: { 'Authorization': 'Bearer <YOUR_API_KEY>' }
}
);
const data = await response.json();
console.log(data);HttpResponse<String> response = Unirest.get("https://api.keyapi.ai/v1/tiktok/shop/livestreams/analytics")
.header("Authorization", "Bearer <token>")
.asString();{
"code": 0,
"message": "success",
"data": [
{
"avatar": "https://p16-pu-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/8f39499ea4964ab3e77a8dd69de7ce73~tplv-tiktok-shrink:96:96.webp?s=PUBLISH&se=false&sh=96_96&sc=avatar&l=202403201000487587F9F97CCB1101112B",
"cover_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/8f39499ea4964ab3e77a8dd69de7ce73~c5_720x720.webp?x-expires=1694055600&x-signature=FSK9hz4bmN0vbprAxtkUmDe4avM%3D",
"create_time": 1693876970,
"duration": 8030,
"finish_time": 1693885000,
"max_views_cnt": 0,
"nick_name": "🛍ubeufashion🛍",
"region": "US",
"room_id": "7275145563308362538",
"seller_id": "7494818275540568755",
"title": "TikTok Shop Fashion Review",
"total_joins_cnt": 2734,
"total_sale_cnt": 0,
"total_sale_gmv_amt": 0,
"total_views_cnt": 3132,
"user_id": "6798340844577768453"
}
],
"requestId": "dbab4133-4b72-4d7d-9579-7ac5107ab76a"
}{
"code": 400,
"data": null,
"message": "Missing required parameter: handle"
}{
"code": 401,
"data": null,
"message": "apiKey is null"
}{
"code": 402,
"data": null,
"message": "apiKey quota is not enough"
}{
"code": 429,
"data": null,
"message": "qps limit exceeded"
}{
"code": 500,
"data": null,
"message": "Internal server error"
}TikTok Shop
Shop Livestreams -EchoTik
Retrieve historical livestream records for a TikTok Shop, including viewer counts, GMV generated, and product sales data from each session.
GET
/
v1
/
tiktok
/
shop
/
livestreams
/
analytics
cURL
curl --request GET \
--url 'https://api.keyapi.ai/v1/tiktok/shop/livestreams/analytics' \
--header 'Authorization: Bearer <YOUR_API_KEY>'import requests
response = requests.get(
'https://api.keyapi.ai/v1/tiktok/shop/livestreams/analytics',
params={},
headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
)
print(response.json())const response = await fetch('https://api.keyapi.ai/v1/tiktok/shop/livestreams/analytics',
{
method: 'GET',
headers: { 'Authorization': 'Bearer <YOUR_API_KEY>' }
}
);
const data = await response.json();
console.log(data);HttpResponse<String> response = Unirest.get("https://api.keyapi.ai/v1/tiktok/shop/livestreams/analytics")
.header("Authorization", "Bearer <token>")
.asString();{
"code": 0,
"message": "success",
"data": [
{
"avatar": "https://p16-pu-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/8f39499ea4964ab3e77a8dd69de7ce73~tplv-tiktok-shrink:96:96.webp?s=PUBLISH&se=false&sh=96_96&sc=avatar&l=202403201000487587F9F97CCB1101112B",
"cover_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/8f39499ea4964ab3e77a8dd69de7ce73~c5_720x720.webp?x-expires=1694055600&x-signature=FSK9hz4bmN0vbprAxtkUmDe4avM%3D",
"create_time": 1693876970,
"duration": 8030,
"finish_time": 1693885000,
"max_views_cnt": 0,
"nick_name": "🛍ubeufashion🛍",
"region": "US",
"room_id": "7275145563308362538",
"seller_id": "7494818275540568755",
"title": "TikTok Shop Fashion Review",
"total_joins_cnt": 2734,
"total_sale_cnt": 0,
"total_sale_gmv_amt": 0,
"total_views_cnt": 3132,
"user_id": "6798340844577768453"
}
],
"requestId": "dbab4133-4b72-4d7d-9579-7ac5107ab76a"
}{
"code": 400,
"data": null,
"message": "Missing required parameter: handle"
}{
"code": 401,
"data": null,
"message": "apiKey is null"
}{
"code": 402,
"data": null,
"message": "apiKey quota is not enough"
}{
"code": 429,
"data": null,
"message": "qps limit exceeded"
}{
"code": 500,
"data": null,
"message": "Internal server error"
}🪙1 creditper request
Copy for AI
🤖 Why Code When AI Can Do It For You?
Stop writing code like it’s 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.
Authorizations
Query Parameters
Shop Id
List sorting enumeration.1=total_views_cnt 2=total_sale_cnt 3=total_sale_gmv_amt
Sort order 0=asc 1=desc
Page numbers start from 1 and go up to a maximum of 100,000.
The maximum number of pages is 10.

