> **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/videos>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/douyin/videos.mdx>

---

# Douyin Video API

Turn a Douyin video link into structured JSON with its counts, sound and files.

`GET /v1/douyin/videos?url=https://www.douyin.com/video/7687419490820295970` returns `data.video`: caption, title, hashtags, `createdAt`, duration to the millisecond, width and height, cover, the MP4 file, `stats` (likes, comments, shares, saves), the sound, whether it is pinned or a paid promotion, and the creator.

A photo post (a douyin.com/note/ link) comes back with `mediaType: images` and its photos. Share links and bare video ids work too. A deleted, private or unknown video returns `lookupStatus: not_found`.

## Request

- **Endpoint:** `GET /v1/douyin/videos`
- **Credits:** 1 credit
Failed requests are free
Found, empty and not-found answers are all charged
- **Input:** by video URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/douyin/videos/get)
- **Platform page:** [/platforms/douyin](https://www.socialfetch.dev/platforms/douyin)

## FAQ

### Which link do I pass?

A video or photo post link (douyin.com/video/{id} or douyin.com/note/{id}), a share link, or the numeric id.

### Why is the view count null?

Douyin hides most view counts from visitors who are not signed in. The other counts are returned.

### Can I keep the video file link?

No. videoUrl is a signed link that expires after a few hours; download the file if you need it.

### How many credits does a video lookup cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
