# Douyin Trending API (https://www.socialcrawl.dev/platforms/douyin/trending)

> Returns the live Douyin hot-search board (抖音热搜): roughly 50 trending topics with rank, hot value, view count, video count and the time the topic broke. This is the highest-signal short-form trend surface in mainland China. The whole board is returned in one call for one flat price.

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

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/douyin/trending" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What is the Douyin hot-search board?

It is 抖音热搜, the ranked list of what mainland China is searching and watching right now. It is the highest-signal short-form trend surface in the Chinese market.

### How often should I poll it?

The board moves through the day, so hourly is enough for most trend tracking. Each call is flat priced and returns the whole ranking, so there is no cost benefit to partial reads.

### What does hot value mean?

It is Douyin's own composite score behind the ordering, useful for measuring how far ahead the top topics sit rather than just reading their rank positions.

### Are the topics in Chinese?

Yes. Trending topics are returned exactly as Douyin publishes them, in Chinese, with no lossy translation applied. Translate downstream if you need English.

### Is there a limit parameter?

No, and that is deliberate. The upstream ignores any row cap, so advertising one would be a promise that could not be kept. You get the whole board for one flat price.

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 track Douyin trending topics with an API
- what is trending on Douyin in China right now