Renvoie les sessions de live shopping animées par un créateur TikTok, avec les chiffres d'audience et de ventes de chacune. Endpoint commerce premium à coût de quota élevé.
/api/v1/tiktok/user/shop/live/listConsommation de quota: Chaque requête réussie vers ce point de terminaison déduit 10 unités de quota de votre forfait.
Paramètres de requête
Paramètres obligatoires
| Nom | Emplacement | Type | Description |
|---|---|---|---|
unique_id | query | string | unique_id example: popmart.usshop |
Paramètres optionnels
| Nom | Emplacement | Type | Description |
|---|---|---|---|
sort_field | query | string | Sort field: live_revenue_amount, live_view_count, live_price, live_revenue_per_thousand |
sort_type | query | string | Sort order: asc = ascending, desc = descending |
page | query | integer | Page number |
Champs de réponse
| Nom | Type | Description |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.items | array<object> | Items |
data.total | integer | Total |
data.page | integer | Page |
data.page_size | integer | Page Size |
data.total_pages | integer | Total Pages |
Tester
Paramètres de requête
unique_id*sort_fieldsort_typepageExemple cURL
curl -X GET "https://openapi.scdata.cc/api/v1/tiktok/user/shop/live/list?unique_id=popmart.usshop" \-H "Authorization: YOUR_API_KEY"
Exemple de réponse (200 application/json)
{"success": true,"code": 200,"message": "Request successful","data": {"items": [{"live_name": "SKULLPANDA Launch!","live_cover_url": "https://d3uucz7wx6jq40.cloudfront.net/tiktok.live/7541145940804029239/cover.png","live_start_time": "08/22 05:00","live_end_time": "08/22 17:08","live_duration": "12.1h","live_revenue_amount": "405921.55","live_view_count": 1647040,"live_price": "43.76","live_revenue_per_thousand": "246.45"}],"total": 35,"page": 1,"page_size": 10,"total_pages": 4}}
Cas d'usage
- Sélection d'animateurs live — Choisissez des créateurs à l'audience live régulière pour un événement de live commerce.
- Benchmarks de performance live — Fixez des objectifs de vente réalistes à partir des résultats passés des lives du créateur.