---
title: "Retrieve posts from a TikTok profile"
method: GET
path: "/tiktok/posts"
tags: ["TikTok"]
---

# Retrieve posts from a TikTok profile

`GET /tiktok/posts`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/tiktok/posts`
- Auth: API key in header `x-api-key`

Lists posts from a TikTok profile identified by `secUid`. `sort_type` is `0` latest (default), `1` popular or `2` oldest. `cursor` defaults to 0. The response has `itemList`, `hasMore` and a `cursor` to pass back to fetch the next page.

## Query parameters

- `secUid` string, required
- `cursor` integer
- `sort_type` 0 | 1 | 2

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TiktokProfilePostResponseDoc
  - `code` integer
  - `data` TiktokUserPostLinkResp
    - `cursor` string: Cursor to pass in the next request to get the next page of posts.
    - `extra` object: Response metadata from TikTok, such as the request log id and server time.
      - `fatal_item_ids` unknown[]
        - unknown
      - `logid` string
      - `now` integer
    - `hasMore` boolean: Whether more posts remain after this page.
    - `itemList` unknown[]: Videos posted by the account, one entry per video, as TikTok returns them.
      - unknown
    - `log_pb` object: Request tracking information from TikTok, holding the `impr_id` impression id.
      - `impr_id` string
    - `status_code` integer: TikTok status code for the request. `0` on a successful response.
    - `status_msg` string: Status message that goes with the status code.
  - `msg` string

## Other responses

- `400`: Invalid input
- `429`: Rate limit exceeded
- `500`: Internal server error

---

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