Metrics

Métriques TikTok via l'API

Votre client connecte son compte TikTok et votre produit interroge 7 métriques par le même endpoint que les autres plateformes. Chaque métrique a un identifiant (reference_key) qui figure dans l'appel.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "comparison_start": "2026-09-01",
  "comparison_end": "2026-09-30",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "tiktok:video_count",
      "component": "number_v1",
      "metrics": [
        "video_count"
      ],
      "dimensions": [
        "video"
      ]
    }
  ]
}
Exemple : « Nombre de vidéos » en octobre, comparé à septembre.

Plus d'exemples d'appels TikTok

Le même endpoint pour chaque type de métrique. Les champs metrics et dimensions de chaque élément viennent du catalogue de la plateforme (GET /api/metrics/{integration_slug}).

Tableau

Vidéos à la une

Vidéos de votre compte pendant la période analysée avec les meilleures performances. Cela peut inclure des contenus utilisés dans des campagnes publicitaires s'ils apparaissent également dans TikTok Studio.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "tiktok:top_videos",
      "component": "datatable_v1",
      "metrics": [
        "view_count",
        "like_count",
        "share_count",
        "comment_count",
        "create_time"
      ],
      "dimensions": [
        "video"
      ]
    }
  ]
}

Chiffre

J'aime au total

Total des likes accumulés des vidéos publiées pendant la période analysée. Le nombre de likes de chaque vidéo reflète le total des likes depuis sa publication — et non les likes reçus pendant la période. Cela peut inclure des contenus utilisés dans des campagnes publicitaires s'ils apparaissent également dans TikTok Studio.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "tiktok:likes",
      "component": "number_v1",
      "metrics": [
        "like_count"
      ],
      "dimensions": [
        "video"
      ]
    }
  ]
}

Chiffres

6 métriques

  • Nombre de vidéos

    Nombre de vidéos publiées sur votre compte pendant la période analysée. Cela peut inclure des contenus utilisés dans des campagnes publicitaires s'ils apparaissent également dans TikTok Studio.

    tiktok:video_count
  • J'aime au total

    Total des likes accumulés des vidéos publiées pendant la période analysée. Le nombre de likes de chaque vidéo reflète le total des likes depuis sa publication — et non les likes reçus pendant la période. Cela peut inclure des contenus utilisés dans des campagnes publicitaires s'ils apparaissent également dans TikTok Studio.

    tiktok:likes
  • Commentaires

    Total des commentaires accumulés des vidéos publiées pendant la période analysée. Le nombre de commentaires de chaque vidéo reflète le total des commentaires depuis sa publication — et non les commentaires reçus pendant la période. Cela peut inclure des contenus utilisés dans des campagnes publicitaires s'ils apparaissent également dans TikTok Studio.

    tiktok:comments
  • Nombre total d'actions

    Total des partages accumulés des vidéos publiées pendant la période analysée. Le nombre de partages de chaque vidéo reflète le total des partages depuis sa publication — et non les partages qui ont eu lieu pendant la période. Cela peut inclure des contenus utilisés dans des campagnes publicitaires s'ils apparaissent également dans TikTok Studio.

    tiktok:share
  • Total de vues

    Total des vues accumulées des vidéos publiées pendant la période analysée. Le nombre de vues de chaque vidéo reflète le total des vues depuis sa publication - et non les vues qui ont eu lieu pendant la période. Cela peut inclure des contenus utilisés dans des campagnes publicitaires si ceux-ci apparaissent également dans TikTok Studio.

    tiktok:views
  • Suiveurs

    Nombre total d'abonnés sur votre compte

    tiktok:follows

Tableaux

1 métrique

  • Vidéos à la une

    Vidéos de votre compte pendant la période analysée avec les meilleures performances. Cela peut inclure des contenus utilisés dans des campagnes publicitaires s'ils apparaissent également dans TikTok Studio.

    tiktok:top_videos

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.