---
title: "Retrieve the TikTok explore feed for a category"
method: GET
path: "/tiktok/explore/{id}"
tags: ["TikTok"]
---

# Retrieve the TikTok explore feed for a category

`GET /tiktok/explore/{id}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/tiktok/explore/{id}`
- Auth: API key in header `x-api-key`

Returns the TikTok explore feed for a category, given its category type `id` from the category endpoint. The response has `itemList` with the videos, `hasMore` and a `cursor`. A feed that comes back empty is reported as an upstream error, not as an empty list.

## Path parameters

- `id` integer, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TiktokExploreResponseDoc
  - `code` integer
  - `data` TiktokExploreResp
    - `cursor` string: Cursor to pass in the next request to get the next page of videos.
    - `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 explore feed for the category, 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.
    - `status_code` integer: Second copy of the TikTok status code, sent as `status_code`. `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)