# Douyin Post API (https://www.socialcrawl.dev/platforms/douyin/post)

> Returns one Douyin video from its URL or aweme ID: caption, creator, likes, comments, shares, saves, hashtags, music, duration, dimensions, cover image and the tagged place when the creator added one. Richer than a search row: this surface carries the creator's total likes and video count, plus the point-of-interest block. Douyin publishes no view counts, so post.engagement.views is null.

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

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Douyin video URL, for example https://www.douyin.com/video/7681266289940544369, or the bare numeric aweme ID. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/douyin/post?url=https%3A%2F%2Fwww.douyin.com%2Fvideo%2F7681266289940544369" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What can I pass as the video identifier?

A full douyin.com watch URL, a v.douyin.com share link, a legacy iesdouyin share path, or the bare numeric aweme ID. Search results return that ID directly, so a round trip works.

### What does this give me that search does not?

The creator's lifetime totals, the audio track URL, and the point-of-interest block when the creator tagged a place. Search rows are lighter and carry none of those.

### Why is the view count null?

Douyin does not publish play counts outside its own app, on this endpoint or any other. Rather than return a zero that reads as no audience, the field is null. Every other counter is real.

### Can I get the video file?

The response carries a playable CDN URL under content.media_urls. Douyin signs those URLs and they expire, so fetch the file promptly rather than storing the link.

### What happens if the video was deleted?

You get a not-found response and the credits are refunded automatically. Empty upstream results are never billed on any SocialCrawl endpoint.

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 get Douyin video details from a URL
- what data can I get from a single Douyin post