Douyin API

Douyin videos, profiles, comments, sounds and the hot search board as JSON, with no developer account.

The API.SH Douyin API turns public Douyin pages into structured JSON. Look up a video by link or id for its description, author, likes, comments, shares, hashtags, music and play URLs, read a video's comments and replies, open an account by sec_uid, check a sound, and read the hot-search board. Douyin does not list an account's videos or answer keyword searches for logged-out visitors, so those are not offered.

Get a free API key Try it in the playground

5 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Douyin hot search list

GET https://api.api.sh/douyin/v1/hot

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Douyin API

Trend tracking

Read the hot-search board with position, phrase, heat value, label and video count to see what is trending in China right now.

/hot

Video analytics

Pull a video's likes, comments, shares, collects, duration, hashtags and IP location for campaign and content research.

/video

Comment and sentiment analysis

Collect comments with likes, reply count and author, and fetch the replies to any comment, page by page.

/video/comments

Creator and account research

Check an account's followers, following, likes received, video count, verification and bio before a partnership.

/user

Sound and music research

Look up a sound for its title, author, duration and how many videos use it.

/music /video

Video archiving and downloads

Get the no-watermark play URL, the watermarked download URL and the cover of a video you have rights to use.

/video

Douyin data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Douyin API endpoints and prices

Every Douyin endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

Douyin hot search list

/douyin/v1/hot

$1 · $2 PAYG

1 credit

Profiles and accounts1

Douyin user profile

/douyin/v1/user

$1 · $2 PAYG

1 credit

Posts and media2

Douyin video details /douyin/v1/video	$1 · $2 PAYG 1 credit
Douyin video comments /douyin/v1/video/comments	$1 · $2 PAYG 1 credit

More data1

Douyin sound

/douyin/v1/music

$1 · $2 PAYG

1 credit

Call the Douyin API

Douyin hot search list: GET https://api.api.sh/douyin/v1/hot

curl "https://api.api.sh/douyin/v1/hot" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/douyin/v1/hot",
    params={},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/douyin/v1/hot");


const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/douyin/v1/hot")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Douyin" and "Douyin hot search list".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 483 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Douyin data

Public data only: no Douyin login, cookies or account needed
One key and one response shape for Douyin and 482 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Douyin API

Douyin's official developer access is the Douyin Open Platform, which is built around mini-programs and authorized apps with its own authentication and tokens. It is not a way to read public video, comment and hot-search data. API.SH needs no Douyin app or login and returns public Douyin data as JSON.

Compared with self-hosting a Douyin scraper from GitHub or running an Apify actor, API.SH gives you one key, one JSON shape and a fixed price per call, and blocks and retries are handled for you.

Douyin API questions

What Douyin data can I get?+

Video details (/douyin/v1/video), video comments and replies (/douyin/v1/video/comments), user profiles (/douyin/v1/user), sounds (/douyin/v1/music) and the hot-search board (/douyin/v1/hot).

How much does the Douyin API cost?+

Every Douyin endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /douyin/v1/hot at 1 credit each.

Is there an official Douyin API?+

Yes, the Douyin Open Platform, which is aimed at mini-programs and apps that users authorize. It is not a public data feed. API.SH is separate and reads public Douyin pages without any app or token.

Do I need a Douyin account or login?+

No. API.SH reads public Douyin pages only. No endpoint uses a login, cookies or anyone's account.

Can I search Douyin by keyword or list a user's videos?+

No. Douyin does not list an account's videos or answer keyword searches for logged-out visitors, so API.SH does not offer either. You can look up a video by link or id, an account by sec_uid or URL, and the hot-search board.

Can I get Douyin videos without the watermark?+

The video route returns the no-watermark play URL with every bitrate and the watermarked download URL. Only use content you have the right to use, and follow Douyin's terms and the law where you live.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /douyin/v1/video with the url of a Douyin video. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.