Get trending TikTok video data

InsightIQ exposes a standardized offset/limit pagination model and normalized attribute naming while abstracting vendor credentials and vendor-specific implementation details.

This endpoint returns popular TikTok videos for a given time period, country, and ranking criteria (likes, views, comments, reposts).

GET /v1/trends/videos

Basic auth

curl 'https://api.staging.insightiq.ai/v1/trends/videos?period=7&country_code=US&work_platform_id=work_platform_01JXY9AZK4KV&sort_by=views&limit=20&offset=0' \
  --request GET \
  --header 'Authorization: Basic YOUR_BASE64_CREDENTIALS'

{
  "work_platform": {
    "id": "id_01JXY9AZK4KV",
    "name": "example",
    "logo_url": "https://example.com/logo"
  },
  "id": "id_01JXY9AZK4KV",
  "video_url": "https://example.com/video",
  "cover_image_url": "https://example.com/cover-image",
  "title": "example",
  "duration": 1,
  "country": {
    "code": "example",
    "name": "example"
  },
  "rank": 1,
  "metadata": {
    "offset": 1,
    "limit": 1,
    "total": 1,
    "has_more": true
  }
}

Query parameters

· 6

period integer · default: 7· enum

Time window in days for trend calculation.

values

7
30

country_code string · default: US· enum

ISO 2-letter country code.

values

AU
BR
CA
EG
FR
DE

work_platform_id string

Work platform ID for the platform on which you want to get the trending TikTok video data

sort_by string · default: views· enum

Sort videos by likes, views, comments, or reposts.

values

like
views
comment
repost

limit integer · default: 20

Number of records to return (max: 100).

offset integer · default: 0

Number of records to skip (must be multiple of limit).

Query parameters

Responses