> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/douyin>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/douyin.mdx>

---

# Douyin API. Creators, videos and trends as JSON.

Look up a Douyin creator, read their videos, open any video with its comments, and follow the hot search board. Every response uses the same envelope.

- Profiles + videos
- Comments
- Hot search board

`GET /v1/douyin/profiles/{secUid}` returns a Douyin creator: display name, Douyin id, bio, avatar, verification, the IP location Douyin shows, and counts for followers, following, public videos and likes received. `/v1/douyin/profiles/{secUid}/videos` returns the videos Douyin shows signed-out visitors on that creator's page, about 20, with `truncated` set when they have more. That list can lag the creator's newest posts by several days.

`GET /v1/douyin/videos?url=` opens one video or photo post with its caption, hashtags, duration, cover, file or photos, likes, comments, shares and saves, its sound and creator. `/v1/douyin/videos/comments` pages through its comments, 20 at a time, and `/v1/douyin/trending` returns the hot search board. Every answer is JSON in the `{ data, meta }` envelope; a miss comes back as `lookupStatus: not_found`, not as an HTTP error.

## What you can get

- Creator profile with bio, avatar, verification, IP location and counts.
- A creator's videos as Douyin shows them to signed-out visitors, about 20, pinned videos first.
- Single videos and photo posts with caption, hashtags, sound, files and counts.
- Video comments, 20 a page, with likes, replies and IP location.
- The hot search board: about 50 phrases with heat scores, plus the rising list.

## Douyin endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Profile | GET /v1/douyin/profiles/{secUid} | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/douyin/profiles/secuid/get) |
| Profile videos | GET /v1/douyin/profiles/{secUid}/videos | 2 credits Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/douyin/profiles/secuid/videos/get) |
| Video | GET /v1/douyin/videos | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/douyin/videos/get) |
| Video comments | GET /v1/douyin/videos/comments | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/douyin/videos/comments/get) |
| Trending | GET /v1/douyin/trending | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/douyin/trending/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_…`). New accounts get 100 free credits, enough to try every route on a few creators.
2. **Pick the creator or video.** Use the id from a profile link (douyin.com/user/MS4wLjABAAAA…) or the whole link for `GET /v1/douyin/profiles/{secUid}`, or a video link for `GET /v1/douyin/videos?url=`. Send `x-api-key` on every request.
3. **Branch and page.** Check `data.lookupStatus` before you store a row. For comments, keep requesting with `page.nextCursor` while `page.hasMore` is true, and bill from `meta.creditsCharged`.

## Pricing

Each Douyin route charges a flat credit amount per completed request, shown on every endpoint page; a creator's videos cost more than the other routes because that answer is much larger. Each page of comments is its own request. Credits never expire on pay-as-you-go packs, and `meta.creditsCharged` on every response is the billing source of truth.

## Compared with the official API

Social Fetch gives every Douyin route one JSON shape: ISO 8601 UTC timestamps (Douyin's China-time board converted), counts as whole numbers rather than 万 and 亿 text, plain-text captions with their hashtags, ids as strings, typed `lookupStatus` responses and opaque cursors. You do not need a Douyin account, an app registration or a user session.

## FAQ

### What Douyin data can I get from the API?

Creator profiles, a creator's videos, single videos and photo posts, video comments, and the hot search board with its rising phrases.

### How do I name a Douyin creator?

Use Douyin's public user id, the long id starting MS4wLjABAAAA in a profile link like douyin.com/user/MS4wLjABAAAA…, or paste the whole link. The short Douyin id shown on the profile is returned as handle, but it cannot be looked up on its own.

### Can I get all of a creator's videos?

No, one page of about 20. Douyin shows visitors who are not signed in one page of a creator's videos, and that page can lag their newest posts by several days; truncated is true when the creator has more.

### What does a private account return?

lookupStatus: private, with the profile. Douyin hides a private account's videos, so its videos list is empty.

### Why are view counts usually null?

Douyin hides most view counts from visitors who are not signed in. Likes, comments, shares and saves are returned.

### Can I store the video file link?

No. videoUrl and the image links are signed and expire. Download the file if you need it; the video page url stays valid.

### Can I search Douyin or read comment replies?

Not yet. Douyin keeps search and replies behind sign-in; each comment carries its reply count.

### How much does the Douyin API cost?

Every Douyin route charges a flat amount per completed request, shown on each endpoint page, and each page of comments is billed separately. A found or not-found answer is a completed request; invalid requests and errors are free. Check meta.creditsCharged on every response. New accounts start with 100 free credits.

## Related

- [Douyin Profile API](https://www.socialfetch.dev/platforms/douyin/profiles-secuid): Bio, verification and counts (`GET /v1/douyin/profiles/{secUid}`).
- [Douyin Profile Videos API](https://www.socialfetch.dev/platforms/douyin/profiles-secuid-videos): A creator's videos as signed-out visitors see them (`GET /v1/douyin/profiles/{secUid}/videos`).
- [Douyin Video API](https://www.socialfetch.dev/platforms/douyin/videos): One video or photo post (`GET /v1/douyin/videos`).
- [Douyin Comments API](https://www.socialfetch.dev/platforms/douyin/videos-comments): A video's comments (`GET /v1/douyin/videos/comments`).
- [Douyin Trending API](https://www.socialfetch.dev/platforms/douyin/trending): The hot search board (`GET /v1/douyin/trending`).
- [Hosted MCP](https://www.socialfetch.dev/mcp): Call Douyin tools from Cursor or Claude with the same credit metering as REST.
