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

> Searches TikTok for user accounts matching a query. Returns matching profiles with follower counts and verification status.

TL;DR: `GET /v1/tiktok/search/users` 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 users |
| `cursor` | no | Cursor to get more users. 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/users?query=cooking" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I search for TikTok users with an API?

Send a GET request to /v1/tiktok/search/users with the query parameter set to a keyword or name. SocialCrawl returns a paginated list of matching accounts with handles, display names, follower counts, avatars, and verification status.

### What fields does the TikTok User Search endpoint return?

Each matching user returns the user id, handle, display name, avatar URL, follower count, verification status, and a short bio excerpt where available — all in the unified schema.

### How do I paginate through TikTok user 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 matching user.

### Can I find verified TikTok creators with this endpoint?

Yes. Each result includes a verified boolean. Filter the response client-side to keep only accounts where verified=true to get a shortlist of verified creators for the query.

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

Each request costs 1 credit on the standard tier regardless of how many users are returned per 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 users with the SocialCrawl API
- What does the SocialCrawl TikTok User Search endpoint return?