# Douyin Search API (https://www.socialcrawl.dev/platforms/douyin/search)

> Returns Douyin videos matching a keyword: caption, creator, likes, comments, shares, saves, hashtags, music, cover image and duration. Chinese, English and mixed queries all work. Douyin does not publish view counts outside its own app, so post.engagement.views is always null on every Douyin endpoint. For creators rather than videos call GET /v1/douyin/search/users.

TL;DR: `GET /v1/douyin/search` 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 |
| --- | --- | --- |
| `query` | yes | Search keywords, for example 美食 or coffee. |
| `limit` | no | Rows to return, 1 to 50. Default 10. Each row costs 5 credits and you are charged only for rows returned. |
| `sort` | no | Result ordering: relevance, most_liked, or latest. Default relevance. (relevance \| most_liked \| latest) |
| `published` | no | Recency window: all, day, week, or half_year. Default all. (all \| day \| week \| half_year) |
| `duration` | no | Length filter: all, under_1m, one_to_five_m, or over_5m. Default all. (all \| under_1m \| one_to_five_m \| over_5m) |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/douyin/search?query=%E7%BE%8E%E9%A3%9F" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### Can I search Douyin in English?

Yes, though Chinese queries surface far more relevant native content. Douyin is a mainland-China network and most captions and hashtags are written in Chinese, so a Chinese keyword returns a much deeper result set.

### Can I sort or filter Douyin search results?

Yes. Sort by relevance, most liked or latest, and narrow by publish window (day, week, half year) or by video length. The filters are applied by Douyin itself, not after the fact.

### How many results can one Douyin search return?

Up to 50 rows per call. Each row is billed at the rate on this endpoint and you pay only for rows actually returned, so a narrow query that matches less costs less.

### Does Douyin search ever return nothing?

In practice, no. Douyin falls back to loosely related videos rather than reporting no match, so a nonsense query still returns rows. Check the captions rather than assuming an empty list means no coverage.

### Do search results include view counts?

No. Douyin publishes no play counts outside its own app, so views is null on every row. Likes, comments, shares and saves are real numbers you can rank and track on.

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 search Douyin videos by keyword with an API
- can I search Douyin in Chinese and English