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

> Returns a Douyin creator's recent videos with caption, likes, comments, shares, saves, hashtags, music and cover image, newest first. Narrow the window with recent_days, or drop pinned posts with exclude_pinned to read genuine recent activity. Douyin publishes no view counts, so post.engagement.views is null.

TL;DR: `GET /v1/douyin/profile/posts` 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 |
| --- | --- | --- |
| `handle` | no | Douyin sec_uid, the MS4wLjAB... string in a profile URL, or the numeric user ID. |
| `url` | no | Full Douyin profile URL. |
| `id` | no | Numeric Douyin user ID. |
| `limit` | no | Rows to return, 1 to 50. Default 10. Each row costs 5 credits and you are charged only for rows returned. |
| `recent_days` | no | Only return videos published in the last N days. Leave unset for the newest regardless of age. |
| `exclude_pinned` | no | Set true to skip videos pinned to the top of the profile, which can be old. |

## Code example

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

## FAQ

### How do I read a creator's real posting cadence?

Set exclude_pinned to true. A pinned Douyin video can be years old and sits at the top of every listing, which makes a creator look more active than they are.

### Can I limit results to recent videos only?

Yes. Set recent_days to the window you care about, for example 30 for the last month or 7 for the last week. Older uploads are dropped before you are billed for them.

### Are these the same fields as Douyin search?

Yes. Both surfaces return the same canonical post shape, so you can merge a creator listing and a keyword search into one dataset without reshaping either.

### How far back can I go?

Up to 50 videos per call, newest first. For a deeper archive raise the limit or narrow the window with recent_days and walk backwards in slices.

### Do image posts appear alongside videos?

Yes. Douyin image-text posts are returned in the same list as ordinary videos and carry the same engagement counters, so a creator's full output is covered.

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 list all videos from a Douyin creator
- how to measure a Douyin creator posting frequency