Metrics

TikTok metrics via API

Your customer connects their TikTok account and your product queries 7 metrics through the same endpoint as every other platform. Each metric has an id (reference_key) that goes in the request.

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"
      ]
    }
  ]
}
Example: "Number of Videos" in October, compared to September.

More TikTok request examples

The same endpoint for every kind of metric. The metrics and dimensions of each item come from the platform catalog (GET /api/metrics/{integration_slug}).

Table

Featured videos

Videos from your account during the analyzed period that performed best with your audience. May include content used in ad campaigns if they also appear in 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"
      ]
    }
  ]
}

Number

Total likes

Total accumulated likes of videos published during the analyzed period. Each video's like count reflects its total lifetime likes since publication — not likes received within the period. May include content used in ad campaigns if they also appear in 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"
      ]
    }
  ]
}

Numbers

6 metrics

  • Number of Videos

    Number of videos published on your account during the analyzed period. May include content used in ad campaigns if they also appear in TikTok Studio.

    tiktok:video_count
  • Total likes

    Total accumulated likes of videos published during the analyzed period. Each video's like count reflects its total lifetime likes since publication — not likes received within the period. May include content used in ad campaigns if they also appear in TikTok Studio.

    tiktok:likes
  • Comments

    Total accumulated comments of videos published during the analyzed period. Each video's comment count reflects its total lifetime comments since publication — not comments received within the period. May include content used in ad campaigns if they also appear in TikTok Studio.

    tiktok:comments
  • Total Shares

    Total accumulated shares of videos published during the analyzed period. Each video's share count reflects its total lifetime shares since publication — not shares that occurred within the period. May include content used in ad campaigns if they also appear in TikTok Studio.

    tiktok:share
  • Total views

    Total accumulated views of videos published during the analyzed period. Each video's view count reflects its total lifetime views since publication — not views that occurred within the period. May include content used in ad campaigns if they also appear in TikTok Studio.

    tiktok:views
  • Follows

    Total number of followers on your account

    tiktok:follows

Tables

1 metric

  • Featured videos

    Videos from your account during the analyzed period that performed best with your audience. May include content used in ad campaigns if they also appear in TikTok Studio.

    tiktok:top_videos

See Connect applied to your product.

Try it for 15 days with no card, or walk our team through your use case.