Synthétise l'activité TikTok Shop d'un créateur : produits promus, totaux de commandes et de ventes, chiffre d'affaires et part des contenus avec lien produit. Endpoint commerce premium au coût par requête élevé.
/api/v1/tiktok/user/shop/saleConsommation 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 |
Champs de réponse
| Nom | Type | Description |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.currency_symbol | string | Currency symbol |
data.revenue_amount | string | Revenue (last 30 days) |
data.sales_volumn | integer | Units sold (last 30 days) |
data.video_revenue_amount | string | Video revenue (last 30 days) |
data.live_revenue_amount | string | Livestream revenue (last 30 days) |
data.avg_sales_price | string | Average selling price (last 30 days) |
data.live_views_number | integer | Livestream views (last 30 days) |
data.video_views_number | integer | Video views (last 30 days) |
data.new_followers_number | integer | New followers (last 30 days) |
data.start_time | string | Start time |
data.end_time | string | End time |
Tester
Paramètres de requête
unique_id*Exemple cURL
curl -X GET "https://openapi.scdata.cc/api/v1/tiktok/user/shop/sale?unique_id=popmart.usshop" \-H "Authorization: YOUR_API_KEY"
Exemple de réponse (200 application/json)
{"success": true,"code": 200,"message": "Request successful","data": {"currency_symbol": "$","revenue_amount": "3132136.98","sales_volumn": 83007,"video_revenue_amount": "309.90","live_revenue_amount": "3123058.84","avg_sales_price": "37.73","live_views_number": 22712398,"video_views_number": 13409031,"new_followers_number": 53000,"start_time": "2025-08-01","end_time": "2025-08-31"}}
Cas d'usage
- Sélection de créateurs affiliés — Classez les créateurs candidats selon leurs ventes réelles plutôt que leur nombre d'abonnés.
- Prévision de commissions — Estimez le chiffre d'affaires qu'un partenariat pourrait générer à partir du volume de ventes historique du créateur.