CHchartmetric
Track

💎 Premium — List Top TikTok Videos for a Track

Return the top TikTok videos associated with a track. When type=trending only, returns trending videos; otherwise the top videos by the selected sort. cm_id is populated when the poster is linked to a Chartmetric artist. Each row carries the video caption, cumulative engagement counters, the daily history behind them, and change rates over the comparison window. Page with limit and offset, narrow with postedWithinDaysAgo or the min/max metric bounds, and set withTotal=true to receive the rows inside an envelope carrying total and available_count rather than as a bare array.

get/api/track/{id}/topVideos

Request

Path parameters

idinteger required

Chartmetric track ID.

Query parameters

type'likes' | 'views' | 'comments' | 'followers' | 'created_at' | 'trending' | 'modified_at' | 'saves' | 'shares'

Sort metric for the returned videos. Defaults to likes; allowed values come from TikTok engagement stats.

limitinteger

Maximum number of videos to return. Max 100.

byTiktokIdboolean

If true, treat id as a TikTok sound ID (string-internally) rather than a Chartmetric track ID. Defaults to false.

offsetinteger

Number of videos to skip from the start of the result set, for paging past the first limit rows. Defaults to 0, max 10,000.

sortOrderDescboolean

Sort direction for type. Defaults to true (highest first).

withTotalboolean

If true, wrap the videos in an object carrying total and available_count so a caller can page to the end. Defaults to false, which returns the bare array.

postedWithinDaysAgointeger

Only return videos posted within this many days. Omit to cover all time.

fromDaysAgointeger

Window in days used as the baseline for the change-rate fields. Defaults to 28, max 365.

minViewsinteger

Only return videos with at least this many views.

maxViewsinteger

Only return videos with at most this many views.

minLikesinteger

Only return videos with at least this many likes.

maxLikesinteger

Only return videos with at most this many likes.

minCommentsinteger

Only return videos with at least this many comments.

maxCommentsinteger

Only return videos with at most this many comments.

minSharesinteger

Only return videos with at least this many shares.

maxSharesinteger

Only return videos with at most this many shares.

minSavesinteger

Only return videos with at least this many saves.

maxSavesinteger

Only return videos with at most this many saves.

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.