---
title: "Returns the list of TikTok posts created during a period of time."
method: GET
path: "/v2/analytics/posts/tiktok"
tags: ["TikTok Analytics Service"]
---

# Returns the list of TikTok posts created during a period of time.

`GET /v2/analytics/posts/tiktok`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/analytics/posts/tiktok`
- Auth: none declared

## Query parameters

- `from` string, required
- `to` string, required
- `timezone` string

## Response `200`

OK

- JsonOkListResponseTikTokPost
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` TikTokPost[]
    - `openId` string
    - `videoId` string
    - `type` string
    - `createTime` string, date-time
    - `coverImageUrl` string
    - `shareUrl` string
    - `videoDescription` string
    - `duration` integer
    - `height` integer
    - `width` integer
    - `title` string
    - `embedLink` string
    - `likeCount` integer
    - `commentCount` integer
    - `shareCount` integer
    - `viewCount` integer
    - `engagement` number, double
    - `reach` integer
    - `fullVideoWatchedRate` number, double
    - `totalTimeWatched` number, double
    - `averageTimeWatched` number, double
    - `impressionSources` TikTokVideoImpressionSources
      - `forYou` number, double
      - `follow` number, double
      - `hashtag` number, double
      - `sound` number, double
      - `personalProfile` number, double
      - `search` number, double

## Changes

- **2026-10-19** `cd0ca612fa01`: 2 info
  - api operation id `downloadTikTokPostsCSV` removed and replaced with `getTiktokPosts`
  - added the media type `application/json` for the response with the status `200`
- **2026-10-19** `6bd5f8435492`: 1 breaking, 1 info
  - removed the media type `application/json` for the response with the status `200`
  - api operation id `getTiktokPosts` removed and replaced with `downloadTikTokPostsCSV`
- **2026-10-19** `28c3aa47609c`: 2 info
  - api operation id `downloadTikTokPostsCSV` removed and replaced with `getTiktokPosts`
  - added the media type `application/json` for the response with the status `200`

[Operation history](https://skmtc.dev/metricool/apis/metricool-api/changes/v2/analytics/posts/tiktok/get.md)

---

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