# TikTok User Search API

Use Scrappa's TikTok user search API to find public TikTok accounts by username, brand name, creator niche, product category, or keyword. The `GET /api/tiktok/user/search` endpoint returns matching user records as structured JSON with cursor-based pagination, so developer teams can build creator discovery, influencer research, social listening, and profile enrichment workflows without maintaining a TikTok search scraper.

## TikTok user search API for creator discovery

Search keywords such as a creator niche, brand term, campaign phrase, location, product category, or username fragment to discover public TikTok accounts. This endpoint is useful when you need a TikTok username search API for influencer databases, creator marketplaces, social CRM enrichment, competitor account discovery, or brand safety review queues.

## What the TikTok user search response returns

The response includes a `users` array with account identifiers and profile fields such as `user_id`, `unique_id`, `nickname`, `avatar`, `follower_count`, and `verified` when the upstream returns them. Use `unique_id` as the human-readable TikTok handle, `user_id` as the stable account identifier for follow-up API calls, `follower_count` for audience-size filtering, and `verified` to separate official or notable accounts from lookalikes.

## How to call the TikTok User Search API

Send a `GET` request to `/api/tiktok/user/search` with the required `keywords` parameter and your Scrappa API key in the `x-api-key` header. Add `count` to control page size and pass the returned `cursor` into the next request when `hasMore` is true.

## Common TikTok user search workflows

Start with this endpoint when you need a seed list of accounts, then enrich or analyze those users with adjacent TikTok endpoints. Discover creators by niche, fetch profile details with the [TikTok User Profile API](/docs/tiktok/tiktok_user_profile), review recent videos with the [TikTok User Posts API](/docs/tiktok/tiktok_user_posts), inspect follower or following graphs with [TikTok Followers API](/docs/tiktok/tiktok_user_followers), or compare account discovery against keyword video search through the [TikTok Feed Search API](/docs/tiktok/tiktok_feed_search).

## Related TikTok API docs

For the full endpoint family, pricing context, and TikTok API use cases, see the [TikTok API overview](/apis/tiktok-api). For authentication details, use the [API authentication guide](/docs/authentication). To test a request before writing code, open the [API playground](/docs/playground).

- **Documentation:** [https://scrappa.co/docs/tiktok/tiktok_user_search](https://scrappa.co/docs/tiktok/tiktok_user_search)
- **API group:** TikTok API
- **Endpoint:** `GET https://scrappa.co/api/tiktok/user/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `keywords` | string | Yes | Search text for public TikTok users. Use a username fragment, brand name, creator niche, product category, or campaign keyword. |
| `count` | integer | No | Number of user matches to return for the page, up to 50. |
| `cursor` | string | No | Pagination cursor from the previous response. Pass this value with the same `keywords` query when `hasMore` is true. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/tiktok/user/search?keywords=skincare+creator&count=10&cursor=0"
```

## Example response

```json
{
    "code": 0,
    "msg": "success",
    "processed_time": 0.74,
    "data": {
        "users": [
            {
                "user_id": "107955",
                "unique_id": "tiktok",
                "nickname": "TikTok",
                "avatar": "https://example.com/avatar.jpeg",
                "follower_count": 88900000,
                "verified": true
            },
            {
                "user_id": "6821796598806348805",
                "unique_id": "example.creator",
                "nickname": "Example Creator",
                "avatar": "https://example.com/creator.jpeg",
                "follower_count": 245000,
                "verified": false
            }
        ],
        "hasMore": true,
        "cursor": "10"
    }
}
```

## Frequently asked questions

### Can I search TikTok users by keyword?

Yes. Send a keyword, username fragment, creator niche, brand term, or campaign phrase to `/api/tiktok/user/search` and Scrappa returns matching public TikTok accounts as structured JSON.

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

The response includes a `users` array with account identifiers and profile fields such as `user_id`, `unique_id`, `nickname`, `avatar`, `follower_count`, and `verified` when available, plus pagination fields such as `hasMore` and `cursor`.

### How do I get more details after finding a TikTok user?

Use `unique_id` or `user_id` from the search result with adjacent Scrappa endpoints such as TikTok User Profile, TikTok User Posts, TikTok Followers, and TikTok Similar Users.

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)