---
title: "Get TikTok Video Trends for a Track"
method: GET
path: "/api/track/{id}/video-trends"
tags: ["Track"]
---

# Get TikTok Video Trends for a Track

`GET /api/track/{id}/video-trends`

## Request

- Base URL: `https://api.chartmetric.com`
- URL: `https://api.chartmetric.com/api/track/{id}/video-trends`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/docs/api/track/:id/video-trends/get.ts> (a function with typed inputs; its response is checked against the schema)

Return the history of likes, comments, and views for a TikTok video over time. `id` here is a TikTok video internal ID, not a Chartmetric track ID.

## Path parameters

- `id` integer, required: TikTok video internal ID (not a Chartmetric track ID). Identifies the specific video to retrieve trends for.

## Query parameters

- `fromDaysAgo` integer: Number of days before today at which the trend window starts. Defaults to 28.

## Response `200`

Success

- object
  - `obj` object[], required
    - `timestp` string, date-time, nullable: Timestamp of the data point in ISO-8601 form.
    - `likes` integer, nullable: Cumulative likes count at this timestamp.
    - `comments` integer, nullable: Cumulative comments count at this timestamp.
    - `views` integer, nullable: Cumulative views count at this timestamp.

---

[API](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api.md) - [All operations](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/revisions/94dac96833a3?raw)