# Douyin Profile API (https://www.socialcrawl.dev/platforms/douyin/profile)

> Returns one Douyin creator: nickname, Douyin ID, bio, avatar, follower and following counts, total likes received, video count, IP region and verification status. Accepts a profile URL, a bare sec_uid, or the numeric user ID. This is the cheapest way to track a follower count on Douyin. For the creator's videos call GET /v1/douyin/profile/posts.

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

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `handle` | no | Douyin sec_uid, the MS4wLjAB... string in a profile URL, or the numeric user ID. |
| `url` | no | Full Douyin profile URL, for example https://www.douyin.com/user/MS4wLjABAAAA... |
| `id` | no | Numeric Douyin user ID. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/douyin/profile?url=https%3A%2F%2Fwww.douyin.com%2Fuser%2FMS4wLjABAAAAtxsy7VmVkU3RN9oIX0vdkh_6-LlQAb0gwI-tDf-bYNg" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What identifies a Douyin creator?

A sec_uid, the MS4wLjAB... string inside a profile URL, or the numeric user ID. You can pass the full profile URL, a share link, or either identifier on its own.

### Is this the cheapest way to track Douyin followers?

Yes. This endpoint fetches profile metadata only and no videos, so it is the lowest-cost Douyin call. Poll it on a schedule to build a follower time series.

### Why is author.username often null?

Most Douyin creators never choose a handle, and Douyin auto-assigns them a numeric one. A number is not a username you could @-mention, so it is not published as one. Use author.id to join records.

### Is the verified flag reliable?

Yes. It reflects a real Douyin verification badge, cross-checked against a second independent source. An ordinary account with no badge comes back false rather than being mislabelled as verified.

### What does the creator's region tell me?

Douyin publishes the province its servers see the account posting from, which is a stronger signal than a self-declared bio location. It arrives on the author record as a Chinese province name.

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 get a Douyin creator follower count via API
- how do I look up a Douyin profile by sec_uid