InsightSocial

Douyin scraper API

The InsightSocial Douyin API has 8 endpoints, from 20 credits a call. A profile call costs 60 credits, about $0.06 on Pro, and your first 10 calls up to 100 credits each are free.

The Douyin scraper API for public creator profiles, videos, comments and search, as JSON, plus the live hot-search board. No Douyin Open Platform app and no user authorization.

8 endpoints · from 20 credits a call · 10 free calls up to 100 credits each · no credit card

curl "https://api.insightsocial.app/v1/douyin/profile?url=https%3A%2F%2Fwww.douyin.com%2Fuser%2FMS4wLjABAAAAexample_sec_uid" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "douyin",
"endpoint": "/v1/douyin/profile",
"schema_version": "2",
"data": {
"author": {
"id": "98765432101",
"username": "example_kitchen",
"display_name": "Example Kitchen",
"avatar_url": "https://cdn.example.com/avatars/example_kitchen.jpg",
"bio": "Home cooking in under 15 minutes. New video every evening.",
"verified": false,
"followers": 1284000,
"followers_approximate": null,
"following": 96,
"posts_count": 538,
"likes_count": 23740000,
"url": "https://www.douyin.com/user/MS4wLjABAAAAexample_sec_uid",
"location": null,
"external_url": null,
"private": null,
"joined_at": null,
"last_post_at": null,
"ext": null
}
},
"unavailable": [],
"credits_used": 0,
"charge_reason": "miss",
"free_call": true
}

What Douyin data can you get?

Public Douyin data only, returned in the same JSON envelope as every other platform.

Creator profiles

Nickname, Douyin ID, bio, follower and following counts, total likes received, video count and verification.

Videos

A creator's recent videos, newest first, and one video in full with likes, comments, shares, saves, hashtags, music and duration.

Comments and replies

Top-level comments under a video with like and reply counts and the commenter's IP region, then the reply thread under any one of them.

Search and trending

Videos and creators by keyword, with filters for recency, length, follower band and account type, and the live hot-search board.

Douyin API endpoints

All 8 Douyin endpoints and their price in credits. 5 are metered: they show a range and charge what the call actually read.

EndpointCreditsWhat it returns
/search50–1,250Returns Douyin videos matching a keyword: caption, creator, likes, comments, shares, saves, hashtags, music, cover image, and duration.
/profile60Returns a Douyin creator's profile: nickname, Douyin ID, bio, avatar, follower and following counts, total likes received, video count, region, and verification.
/profile/posts50–1,250Returns a Douyin creator's recent videos, newest first: caption, likes, comments, shares, saves, hashtags, music, and cover image.
/post100Returns one Douyin video: caption, creator, likes, comments, shares, saves, hashtags, music, duration, dimensions, cover image, and tagged place when set.
/post/comments20–1,000Returns top-level comments on a Douyin video: text, commenter, like count, reply count, IP region, and whether the creator liked it.
/comment/replies50–2,500Returns the reply thread under one Douyin comment: text, replier, like count, IP region, and verification, each tagged with the parent comment id.
/search/users50–1,250Returns Douyin creators matching a keyword: nickname, Douyin ID, bio, follower count, total likes received, avatar, profile URL, and verification label.
/trending250Returns the live Douyin hot-search board: roughly 50 trending topics with rank, hot value, view count, video count, and the time each topic broke.

Parameters, response fields and examples for each endpoint are in the Douyin API reference.

InsightSocial vs the official Douyin API

The Douyin Open Platform needs a registered app, and its user and video endpoints act on the Douyin users who authorize that app through OAuth.

InsightSocial APIOfficial Douyin API
Whose dataAny public creator or videoUsers who authorize your app
SetupSign in and copy a keyAn app on the Douyin Open Platform, then OAuth per user
Cost per call60 creditsNo per-call price; access depends on your app and each user's authorization

The official API is the right tool for posting, messaging or managing accounts you own. This one is read-only public data.

How much does the Douyin API cost?

Douyin calls start at 20 credits. Every endpoint's price is in the table above and in the free GET /v1/endpoints catalogue, so you know the cost before you call. Pro's 10,000 monthly credits cover about 166 profiles at 60 credits each.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Repeats and retries

    A repeat call is charged again: the full price when it fetches new data, 2 credits when the answer comes from the shared cache. Add fresh=1 to force a new read. Only a retry with the same Idempotency-Key is free.

  • One balance

    API calls and Chrome extension exports share the same credits. The free plan includes 500 a month.

Not writing code?

Connect InsightSocial to Claude or ChatGPT and ask for Douyin data in plain English. Same account, same credits.

Use it from Claude or ChatGPT

Douyin API: frequently asked questions

The Douyin Open Platform works through apps: you register one, and its user and video endpoints read the Douyin accounts that authorize it with OAuth. The InsightSocial API reads any public creator, video or comment thread by URL, with one key and no app.