---
title: "Search TikTok videos"
method: GET
path: "/tiktok/search"
tags: ["TikTok"]
---

# Search TikTok videos

`GET /tiktok/search`

## Request

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

Searches TikTok videos for `keyword`. `cursor` defaults to 0 and `count` defaults to 20, capped at 50. The response has the matching video items, a `cursor` and `has_more` for paging. An empty, blocked or malformed result from TikTok returns an upstream error.

## Query parameters

- `keyword` string, required
- `cursor` integer
- `count` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TiktokSearchResponseDoc
  - `code` integer
  - `data` TiktokSearchResp
    - `cursor` integer: Cursor to pass in the next request to get the next page of results.
    - `data` unknown[]: Search results, one entry per matching video, as TikTok returns them.
      - unknown
    - `extra` unknown
    - `feedback_type` string: Feedback type label that TikTok returns with the search results.
    - `has_more` integer: Whether more results remain after this page, as a number (`1` for yes).
    - `input_keyword` string: Search keyword that was run.
    - `itemList` unknown[]: Matching videos, as TikTok returns them. Often `null` when results are in `data`.
      - unknown
    - `log_pb` object: Request tracking information from TikTok, holding the `impr_id` impression id.
      - `impr_id` string
    - `qc` string: Query token that TikTok returns with the search results.
    - `rid` string: Request id that TikTok returns with the search results.
    - `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.
    - `type` integer: Result type code that TikTok returns with the search results.
  - `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/afac9b012a27?raw)