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

# Tiktok Search

`GET /tiktok/search`

## Request

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

Search TikTok videos by keyword.

## Query parameters

- `query` string, required
- `limit` integer
- `access_key` string

## Response `200`

Search results returned

- object: Search results returned
  - `success` boolean, required
  - `data` object, required
    - `query` string
    - `results` object[]
      - `id` string
      - `desc` string
      - `url` string
      - `createTime` integer
      - `durationSeconds` unknown
      - `thumbnailUrl` unknown
      - `publishedAt` unknown
      - `author` object
        - `id` string
        - `uniqueId` string
        - `nickname` string
        - `avatar` string
        - `verified` boolean
      - `stats` object
        - `views` integer
        - `likes` integer
        - `comments` integer
        - `shares` integer
        - `saves` integer
    - `hasMore` boolean
    - `cursor` string

## Other responses

- `400`: Invalid or missing request input
- `401`: Access key is missing
- `403`: Access key is invalid or the project has insufficient credits
- `404`: Content not found or unavailable
- `422`: Unsupported input or documented media restriction
- `429`: Project rate limit exceeded
- `500`: Internal server error
- `502`: Upstream query rejected or malformed response
- `503`: Upstream service temporarily unavailable; retry later
- `504`: Extraction or upstream operation timed out

---

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