# 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 row RETURNED. The call holds `limit x 5` up front - the default limit of 10 holds 50 and the 25 maximum holds 125 - and settles down to the videos actually delivered, so a creator with 4 recent videos costs 20 credits however high `limit` was set. `recent_days` and `exclude_pinned` narrow the result set BEFORE billing settles, so they lower the charge as well as the noise 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 25. 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. |
| `since` | no | Only rows published on or after this date: YYYY-MM-DD (midnight UTC) or an ISO 8601 timestamp. Rows older than it are left off each page. This list is not in date order, so the walk does not stop at the date: keep following `next_cursor`, and each page costs what a page costs even when every row on it is filtered out. A row with no date is kept. `published_after`, `start_date`, `from_date`, `publish_time` (`yesterday`, `this-week`, `this-month`, `last-3-months`, `last-6-months`) and `max_age_days` are accepted and applied as `since`. |
| `until` | no | Only rows published on or before this date: YYYY-MM-DD (that whole UTC day is included) or an ISO 8601 timestamp. Newer rows are left off each page and the walk does not stop, so older pages follow. A row with no date is kept. `published_before`, `end_date` and `to_date` are accepted and applied as `until`. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/douyin/profile/posts" \
  --data-urlencode "url=https://www.douyin.com/user/MS4wLjABAAAAtxsy7VmVkU3RN9oIX0vdkh_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 25 videos per call, newest first. For a deeper archive 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