---
title: "Top Search"
method: GET
path: "/v1/tiktok/search/top"
tags: ["TikTok"]
---

# Top Search

`GET /v1/tiktok/search/top`

Searches TikTok's 'Top' results by query — returns both videos and photo carousels, unlike keyword search which only returns videos. Returns `items`, an array of objects each with `id`, `desc` (caption), `content_type` (video or photo carousel), `statistics` (play_count, digg_count/likes, comment_count, share_count), `video` info, and `images` for carousels. Paginate with `cursor`. TikTok may return duplicate results.

## Query parameters

- `query` string, required
- `publish_time` 'yesterday' | 'this-week' | 'this-month' | 'last-3-months' | 'last-6-months' | 'all-time'
- `sort_by` 'relevance' | 'most-liked' | 'date-posted'
- `region` string
- `cursor` number

## Response `200`

Successful response

---

[API](https://skmtc.dev/scrapecreators/apis/scrape-creators-api.md) · [All operations](https://skmtc.dev/scrapecreators/apis/scrape-creators-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scrapecreators/scrape-creators-api/revisions/e9ec3dbbd8b8/schema)