Vidéos publicitaires d'un créateur TikTok

Renvoie les vidéos dans lesquelles un créateur TikTok a promu des produits, avec le produit lié, l'engagement et les ventes attribuées. Endpoint commerce premium à coût de quota élevé.

GET/api/v1/tiktok/user/shop/video/ad/list

Consommation 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: revenue_amount, views_count, ads_deal_rate, ads_view_rate, ads_roas_rate
`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

URL de la requête

https://openapi.scdata.cc/api/v1/tiktok/user/shop/video/ad/list

Authorization

Sélectionnez une clé API du tableau de bord

Ajoutez une clé API avant d'envoyer une requête.Ouvrir le tableau de bord

Paramètres de requête

unique_id*

sort_field

sort_type

page

Exemple cURL

bash

curl -X GET "https://openapi.scdata.cc/api/v1/tiktok/user/shop/video/ad/list?unique_id=popmart.usshop" \
  -H "Authorization: YOUR_API_KEY"

Exemple de réponse (200 application/json)

json

{
  "success": true,
  "code": 200,
  "message": "Request successful",
  "data": {
    "items": [
      {
        "video_id": "7483378078563962142",
        "video_description": "I love.❤️  #popmart #skullpanda #wintersymphony #blindbox #vinyl #plush ",
        "video_url": "https://www.tiktok.com/@popmart.usshop/video/7483378078563962142",
        "video_cover_url": "https://d3uucz7wx6jq40.cloudfront.net/tiktok.video/7483378078563962142/cover.png",
        "video_publish_at": "2024-03-29",
        "revenue_amount": "309.90",
        "view_count": 47129,
        "like_count": 18310,
        "comment_count": 197,
        "share_count": 1198,
        "ads_deal_rate": "0",
        "ads_view_rate": "0",
        "ads_roas_rate": "0"
      }
    ],
    "total": 47,
    "page": 1,
    "page_size": 10,
    "total_pages": 5
  }
}

Cas d'usage

Benchmark créatif — Étudiez quelles vidéos produit d'un créateur ont le mieux converti avant de briefer une nouvelle vidéo.
Vérification d'expérience par catégorie — Confirmez qu'un créateur a déjà vendu des produits de votre catégorie.

Vidéos publicitaires d'un créateur TikTok

Paramètres de requête

Paramètres obligatoires

Paramètres optionnels

Champs de réponse

Tester

Paramètres de requête

Exemple cURL

Exemple de réponse (200 application/json)

Cas d'usage

Points de terminaison associés