---
title: "TikTok video insights"
method: GET
path: "/api/v1/analytics/tiktok/video-insights"
tags: ["Analytics"]
---

# TikTok video insights

`GET /api/v1/analytics/tiktok/video-insights`

## Request

- Base URL: `https://app.tryadeli.com`
- URL: `https://app.tryadeli.com/api/v1/analytics/tiktok/video-insights`
- Auth: HTTP bearer

## Query parameters

- `accountId` string, uuid, required
- `profileId` string, uuid
- `videoIds` string

## Response `200`

Success

- object
  - `platform` 'tiktok', required
  - `accountId` string, uuid, required
  - `profileId` string, uuid, required
  - `videos` object[], required
    - `id` string, required
    - `mediaType` 'VIDEO' | 'PHOTO', required
    - `isAd` boolean, required
    - `caption` string, nullable, required
    - `coverImageUrl` string, nullable, required
    - `shareUrl` string, nullable, required
    - `embedUrl` string, nullable, required
    - `durationSeconds` number, nullable, required
    - `likeCount` number, nullable, required
    - `commentCount` number, nullable, required
    - `shareCount` number, nullable, required
    - `favoriteCount` number, nullable, required
    - `viewCount` number, nullable, required
    - `reach` number, nullable, required
    - `createdAt` string, date-time, nullable, required
    - `insights` object
      - `totalTimeWatchedSeconds` number, nullable, required
      - `averageTimeWatchedSeconds` number, nullable, required
      - `fullVideoWatchedRate` number, nullable, required
      - `newFollowers` number, nullable, required
      - `profileViews` number, nullable, required
      - `retention` object[], required
        - `second` string, required
        - `percentage` number, required
      - `impressionSources` object[], required
        - `name` string, required
        - `percentage` number, nullable, required
      - `audienceGenders` object[], required
        - `name` string, required
        - `percentage` number, nullable, required
      - `audienceCountries` object[], required
        - `name` string, required
        - `percentage` number, nullable, required
      - `audienceCities` object[], required
        - `name` string, required
        - `percentage` number, nullable, required
      - `audienceTypes` object[], required
        - `name` string, required
        - `percentage` number, nullable, required
  - `fetchedAt` string, date-time, required

## Other responses

- `400`: Invalid request or provider failure
- `401`: Missing or invalid API key
- `403`: The connection lacks a permission or provider-confirmed resource
- `404`: Profile, account, or object not found
- `422`: The connected account cannot perform this operation
- `429`: Provider quota or rate limit exhausted
- `502`: Invalid request or provider failure

## Changes

- **2026-10-20** `7a149f5a838a`: 11 breaking, 14 warning, 6 info
  - the response property `error/details` became optional for the status `403`
  - the response property `error/details/capability` became optional for the status `403`
  - the response property `error/details/missingPermissions` became optional for the status `403`
  - the response property `error/details/missingResources` became optional for the status `403`
  - …27 more

[Operation history](https://skmtc.dev/tryadeli/apis/adeli-api/changes/api/v1/analytics/tiktok/video-insights/get.md)

---

[API](https://skmtc.dev/tryadeli/apis/adeli-api.md) · [All operations](https://skmtc.dev/tryadeli/apis/adeli-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tryadeli/apis/adeli-api/revisions/7a149f5a838a?raw)