---
title: "Retrieve TikTok trending posts"
method: GET
path: "/tiktok/trending"
tags: ["TikTok"]
---

# Retrieve TikTok trending posts

`GET /tiktok/trending`

## Request

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

Returns the current TikTok trending feed: `itemList` holds the videos, and `hasMore` and `cursor` describe paging. The response also has a `trendingTopics` field. Takes no parameters.

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TiktokTrendingResponseDoc
  - `code` integer
  - `data` TiktokTrendingResp
    - `cursor` string: Cursor TikTok returns for the next page of the trending feed.
    - `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 videos remain after this page.
    - `itemList` unknown[]: Videos in the trending feed, 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
    - `statusCode` integer: TikTok status code for the request. `0` on a successful response.
    - `statusMsg` string: Status message that goes with the status code.
    - `status_code` integer: Second copy of the TikTok status code, sent as `status_code`. `0` on a successful response.
    - `status_msg` string: Second copy of the status message, sent as `status_msg`.
    - `trendingTopics` unknown[]: Trending topics returned with the feed, as TikTok returns them.
      - unknown
  - `msg` string

## Other responses

- `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)