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

> Searches TikTok for videos matching a keyword query. Returns a list of matching videos with view counts, like counts, captions, author info, and thumbnails.

TL;DR: `GET /v1/tiktok/search` 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 to find TikTok videos |
| `date_posted` | no | Time Frame (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. |
| `trim` | no | Set to true to get a trimmed response |

## Code example

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

## FAQ

### How do I search TikTok videos with an API?

Send a GET request to /v1/tiktok/search with the query parameter set to your keyword. SocialCrawl returns a paginated list of matching videos with view, like, comment, and share counts plus captions, thumbnails, and author info.

### Can I filter TikTok search results by date?

Yes. Pass date_posted with one of: yesterday, this-week, this-month, last-3-months, last-6-months, or all-time. Combine it with sort_by for targeted results.

### How do I sort TikTok search results?

Pass sort_by with one of three values: relevance (default), most-liked, or date-posted. Combined with date_posted you can find recent viral content or evergreen top performers.

### Does region filter search results to a country?

No. The region parameter routes the proxy through a specific country (e.g., US, GB, FR) so you can access content available in that region. It does not filter results to creators based in that country.

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

Each request costs 1 credit on the standard tier regardless of how many results are 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:

- How to search TikTok videos with the SocialCrawl API
- What filters does the SocialCrawl TikTok Search API support?