---
title: "List public TikTok videos with engagement metrics"
method: GET
path: "/tiktok/posts-with-analytics/{accountId}"
tags: ["TikTok", "Analytics"]
---

# List public TikTok videos with engagement metrics

`GET /tiktok/posts-with-analytics/{accountId}`

## Request

- Base URL: `https://socialrobot.io/api/v1`
- URL: `https://socialrobot.io/api/v1/tiktok/posts-with-analytics/{accountId}`
- Auth: API key in header `x-api-key`

Returns recent public videos for a connected TikTok account via video.list, including view/like/comment/share counts.

## Path parameters

- `accountId` string, required

## Query parameters

- `limit` number
- `startDate` string
- `endDate` string

## Headers

- `x-api-key` string, required: The API key to use for the request

## Response `200`

Videos with analytics fetched successfully

- object[]
  - `id` string, required
  - `create_time` number, required
  - `cover_image_url` string, nullable
  - `share_url` string, nullable
  - `video_description` string, nullable
  - `duration` number, nullable
  - `title` string, nullable
  - `like_count` number, required
  - `comment_count` number, required
  - `share_count` number, required
  - `view_count` number, required
  - `engagements` number, required
  - `publishedAt` string, date-time, nullable, required
  - `performanceRank` integer
  - `viewsDelta` number, nullable
  - `viewsGrowthRate` number, nullable
  - `historicalData` object[], required
    - `index` number, required
    - `timestamp` union, required
      - string, date-time
      - string
    - `views` number, required
    - `likes` number, required
    - `comments` number, required
    - `shares` number, required
    - `engagements` number, required

## Other responses

- `401`: Unauthorized - Invalid or missing API key
- `403`: Forbidden - plan limit, ownership, or quota exceeded (see error message for upgrade link)
- `500`: Internal server error

---

[API](https://skmtc.dev/socialrobot/apis/socialrobot-io-scheduler-api.md) · [All operations](https://skmtc.dev/socialrobot/apis/socialrobot-io-scheduler-api/llms.txt) · [OpenAPI document](https://skmtc.dev/socialrobot/apis/socialrobot-io-scheduler-api/revisions/c2e9cdf5e75e?raw)