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

> Returns Douyin creators matching a keyword: nickname, Douyin ID, bio, follower count, total likes received, avatar, profile URL and verification label. Filter by follower band or by account type to shortlist creators for outreach. This lane paginates: pass the returned cursor to walk deeper.

TL;DR: `GET /v1/douyin/search/users` costs 5 credits 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 keywords, for example 美食 or a brand name. |
| `limit` | no | Rows to return, 1 to 50. Default 10. Each row costs 5 credits and you are charged only for rows returned. |
| `cursor` | no | Continuation token from a previous response's pagination block. Omit for the first page. |
| `followers` | no | Follower band: all, under_1k, 1k_to_10k, 10k_to_100k, 100k_to_1m, or over_1m. Default all. (all \| under_1k \| 1k_to_10k \| 10k_to_100k \| 100k_to_1m \| over_1m) |
| `user_type` | no | Account type: all, regular_user, enterprise_verified, or individual_verified. Default all. (all \| regular_user \| enterprise_verified \| individual_verified) |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/douyin/search/users?query=%E7%BE%8E%E9%A3%9F" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### Can I filter by audience size?

Yes. Narrow to under 1k, 1k to 10k, 10k to 100k, 100k to 1m or over 1m followers, so you spend calls only on creators in the tier you actually work with.

### Can I find business accounts specifically?

Yes. Filter by account type to return only enterprise-verified accounts, only individually verified creators, or only ordinary users.

### Does this endpoint paginate?

Yes. It returns a cursor whenever more creators are available. Pass it back to walk further down the ranking rather than re-running the same first page.

### Do I get a usable handle for each creator?

You get the Douyin ID, which is the closest thing the platform has to a public handle. Many creators only have an auto-assigned numeric one, in which case the field is null and you join on the ID.

### How does this compare with video search?

Video search finds content on a topic; this finds the accounts behind it. For outreach, shortlist here first, then pull the profile or their uploads only for creators that pass your filter.

See the full Douyin API: https://www.socialcrawl.dev/platforms/douyin

## 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 find Douyin influencers by keyword
- how to filter Douyin creators by follower count