# TikTok Search Top API (https://www.socialcrawl.dev/platforms/tiktok/search-top)

> Returns top search results for a keyword query on TikTok, including accounts, videos, and sounds.

TL;DR: `GET /v1/tiktok/search/top` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search keyword or phrase |
| `publish_time` | no | Time Frame TikTok was posted (yesterday \| this-week \| this-month \| last-3-months \| last-6-months \| all-time) |
| `sort_by` | no | Sort by (relevance \| most-liked \| date-posted) |
| `region` | no | Note, this doesn't filter the tiktoks only in a specfic region, it puts the proxy there. Use it in case you want to scrape posts only available for some country. Use 2 letter country codes like US, GB, FR, etc |
| `cursor` | no | Cursor to get more videos. Get 'cursor' from previous response. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/tiktok/search/top?query=dance%20challenge" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the TikTok Top Search endpoint return?

It returns TikTok's blended top search results for a keyword — a mix of accounts, videos, and sounds in one response. Each item includes its type, id, and type-specific fields like follower counts, view counts, or track metadata.

### How is Top Search different from the keyword Search endpoint?

The /v1/tiktok/search endpoint returns videos only. The /v1/tiktok/search/top endpoint returns TikTok's top tab — a blended mix of accounts, videos, and sounds, matching what users see in the app.

### Can I filter Top Search results by date or sort order?

Yes. Pass publish_time (yesterday, this-week, this-month, last-3-months, last-6-months, all-time) and sort_by (relevance, most-liked, date-posted) to narrow the result set.

### How do I paginate through Top Search results?

Read the cursor field from the response and pass it as the cursor parameter on your next request. Repeat until cursor is 0 or empty to collect every result for the query.

### How much does the TikTok Top Search API cost?

Each request costs 1 credit on the standard tier regardless of how many items are returned in the page. New accounts get 100 free credits with no credit card required.

See the full TikTok API: https://www.socialcrawl.dev/platforms/tiktok

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What is the SocialCrawl TikTok Top Search API?
- How to get mixed TikTok search results with the SocialCrawl API