Douyin API. Creators, videos and trends as JSON.
Look up a Douyin creator, read their videos, open any video with its comments, and follow the hot search board. Every response uses the same envelope.
- Profiles + videos
- Comments
- Hot search board
- Failed requests aren't charged
Teams running monitoring, research, and enrichment pipelines
Why Social Fetch
Douyin data as JSON. You build the product.
Live Douyin data in one response shape, with platform changes handled for you.
Douyin, plus every other platform
One key and one response envelope for Douyin and 86 more platforms.
API key
sk_live_••••••••
Pricing you can reason about
One request, one credit. Know how far your balance will go before you run your next batch.
- Requests
- 480
- Credits
- 480
Balance
Live data on every request
Fetch public data when you ask for it.
Nothing to maintain
We handle platform changes and breakages.
Built for production jobs
Run concurrent workloads with explicit statuses and request IDs.
lookupStatus: found
Regular jobs. Better rates.
Running lookups every month? Get lower per-credit rates with a monthly plan. For occasional projects, choose pay as you go.
What Douyin data can you get?
5 endpoints, one API key. Every response comes back as live JSON in the same envelope.
Profiles
Videos
Trending
Browse all 5 Douyin endpoints
Example request
GET /v1/douyin/profiles/{secUid}. Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
What teams build with Douyin data
Monitoring, enrichment, research and content workflows on Douyin data, on the same API as every other platform.
How it works
Your first request in three steps.
Use TypeScript or your automation tool of choice.
API key
sfk_live_••••••••••••
Free requests100
Step 1: Create your free account
Get an API key with 100 requests included.
GET/v2/instagram/profiles/charlidamelio
1 request · 1 credit
Step 2: Choose an endpoint
Pass a username, URL, keyword, or post ID.
200 OK1.82s
{
"handle": "charlidamelio",
"displayName": "Charli D'Amelio",
"followers": 48300000,
"following": 1284
}
Step 3: Get clean JSON
Use the response immediately or send it into your pipeline.
Works with your stack
Code, automate, or connect your AI.
Pricing
Social data, priced simply.
Start with 100 free credits. Monthly plans give you predictable volume and lower per-request rates.
Starter
18,000credits
$1.61 per 1k · $0.00161 per request
- Top up from $1.61 / 1k if you run out
- Up to 25 monitors
Growth
50,000credits
$1.58 per 1k · $0.00158 per request
- Top up from $1.58 / 1k if you run out
- 5 team seats
- Up to 100 monitors
Scale
150,000credits
$1.50 per 1k · $0.00150 per request
- Top up from $1.50 / 1k if you run out
- 25 team seats
- Up to 250 monitors
- Cancel anytime
- 30-day money-back guarantee
- Price locked while you stay
Need 1M+ credits, invoicing, or volume rates? Talk to us
Trust signals
DevHunt
Product Hunt
Uneed
Customers
Teams building on Social Fetch.
“Our TikTok and Instagram scrapers broke constantly. Social Fetch took us off that rotation — we ship product again.”
“A maker pastes one link and Social Fetch fills in their bio and socials. Most of inko runs on it, and it just works.”
Jade P. · Founder, inko “Live profile data on every request. We never flag accounts from a stale cache.”
Hannah Webb · Founder, Scam Finder “Heavy concurrent load, no rate limits to negotiate. The rare API I haven't wrapped in retries.”
Owen Pritchard · Founder, IP Flare
Douyin API: common questions
What Douyin data can I get from the API?
Creator profiles, a creator's videos, single videos and photo posts, video comments, and the hot search board with its rising phrases.
How do I name a Douyin creator?
Use Douyin's public user id, the long id starting MS4wLjABAAAA in a profile link like douyin.com/user/MS4wLjABAAAA…, or paste the whole link. The short Douyin id shown on the profile is returned as handle, but it cannot be looked up on its own.
Can I get all of a creator's videos?
No, one page of about 20. Douyin shows visitors who are not signed in one page of a creator's videos, and that page can lag their newest posts by several days; truncated is true when the creator has more.
What does a private account return?
lookupStatus: private, with the profile. Douyin hides a private account's videos, so its videos list is empty.
Why are view counts usually null?
Douyin hides most view counts from visitors who are not signed in. Likes, comments, shares and saves are returned.
Can I store the video file link?
No. videoUrl and the image links are signed and expire. Download the file if you need it; the video page url stays valid.
Can I search Douyin or read comment replies?
Not yet. Douyin keeps search and replies behind sign-in; each comment carries its reply count.
How much does the Douyin API cost?
Every Douyin route charges a flat amount per completed request, shown on each endpoint page, and each page of comments is billed separately. A found or not-found answer is a completed request; invalid requests and errors are free. Check meta.creditsCharged on every response. New accounts start with 100 free credits.
The Douyin API in detailHow the Douyin routes work, what they cost, and how they differ from the official API.
Why teams use Social Fetch for Douyin
GET /v1/douyin/profiles/{secUid} returns a Douyin creator: display name, Douyin id, bio, avatar, verification, the IP location Douyin shows, and counts for followers, following, public videos and likes received. /v1/douyin/profiles/{secUid}/videos returns the videos Douyin shows signed-out visitors on that creator's page, about 20, with truncated set when they have more. That list can lag the creator's newest posts by several days.
GET /v1/douyin/videos?url= opens one video or photo post with its caption, hashtags, duration, cover, file or photos, likes, comments, shares and saves, its sound and creator. /v1/douyin/videos/comments pages through its comments, 20 at a time, and /v1/douyin/trending returns the hot search board. Every answer is JSON in the { data, meta } envelope; a miss comes back as lookupStatus: not_found, not as an HTTP error.
How to call the Douyin API
1. Create an API key
Sign up at Social Fetch and copy a key (
sfk_…). New accounts get 100 free credits, enough to try every route on a few creators.2. Pick the creator or video
Use the id from a profile link (douyin.com/user/MS4wLjABAAAA…) or the whole link for
GET /v1/douyin/profiles/{secUid}, or a video link forGET /v1/douyin/videos?url=. Sendx-api-keyon every request.3. Branch and page
Check
data.lookupStatusbefore you store a row. For comments, keep requesting withpage.nextCursorwhilepage.hasMoreis true, and bill frommeta.creditsCharged.
What each Douyin route returns
- Creator profile with bio, avatar, verification, IP location and counts.
- A creator's videos as Douyin shows them to signed-out visitors, about 20, pinned videos first.
- Single videos and photo posts with caption, hashtags, sound, files and counts.
- Video comments, 20 a page, with likes, replies and IP location.
- The hot search board: about 50 phrases with heat scores, plus the rising list.
How much does the Douyin API cost?
Each Douyin route charges a flat credit amount per completed request, shown on every endpoint page; a creator's videos cost more than the other routes because that answer is much larger. Each page of comments is its own request. Credits never expire on pay-as-you-go packs, and meta.creditsCharged on every response is the billing source of truth.
Social Fetch vs the official Douyin API
Social Fetch gives every Douyin route one JSON shape: ISO 8601 UTC timestamps (Douyin's China-time board converted), counts as whole numbers rather than 万 and 亿 text, plain-text captions with their hashtags, ids as strings, typed lookupStatus responses and opaque cursors. You do not need a Douyin account, an app registration or a user session.
Pull your first Douyin data.
Run a live Douyin request in the playground. 100 free credits, no card, JSON back in seconds.
No credit cardSign up in 30 seconds withGoogleGitHub