Douyin Public Data APIs
Retrieve public profiles and videos, search videos, collect one page of comments or creator videos, and inspect a known live room.
Available Douyin APIs
Choose from six APIs for profile, video, comment, search, and live-room workflows.
What Douyin data can you retrieve?
The Douyin catalog returns normalized account, reel-video, comment, and live-room records from public source data.
Profiles and creator videos
Resolve a public profile or collect one source page of videos from a supported profile URL or user_id.
Video details, search, and comments
Inspect a supported video reference, search the fixed first source page by query, or collect one page of comments.
Live-room details
Retrieve one known live room by digit-only room_id with available host, status, media, and visible audience fields.
Douyin API contracts at a glance
Each endpoint has a bounded source request and rejects undeclared parameters.
| API group | Starting input | Source boundary |
|---|---|---|
| Profile and creator videos | url or user_id | One profile or one source page; creator videos support results_limit 1–20 |
| Video detail and comments | Supported URL | One detail record or one comment page; comments support results_limit 1–20 |
| Video search | Non-empty query | Fixed first source page with no results_limit |
| Live room | Digit-only room_id | At most one live-room record |
How the Douyin APIs work
All six endpoints use the same asynchronous submit, poll, and stored-result workflow.
1. Choose the endpoint
Select the profile, video, comment, search, or live-room endpoint that matches the public reference you already have.
2. Submit valid input
POST only the declared fields and save the returned task_id.
3. Read normalized results
Poll the task to a terminal state, then read data.results.items and use next_cursor only for stored-result pagination.
Authenticate with a SocQ API key and submit a non-empty query. A successful Douyin task costs a fixed 0.10 credits.
curl -X POST "https://api.socq.ai/v1/douyin/video-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"artificial intelligence"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after successCommon Douyin API use cases
Creator research
Combine public profile identity with a bounded page of creator videos and visible engagement.
Content and conversation review
Enrich known videos, search a topic snapshot, and inspect one public comment page.
Live-room monitoring
Record a known public live-room snapshot using an explicit numeric room identifier.
Limits and public-data policy
These endpoints read public data through bounded source requests and do not provide account actions or continuous monitoring.
- user_id accepts 1–256 ASCII letters, numbers, colons, underscores, or hyphens; profile URLs must contain /user/{identifier} on a supported Douyin host.
- room_id is a string containing digits only; keep long identifiers out of JavaScript number values.
- results_limit is available only for User Videos and Video Comments, with a range of 1–20 and a default of 20.
- Video Search is fixed to the first source page; task-result cursors only paginate records already stored for that task.
- Every successful Douyin task costs a fixed 0.10 credits.
Douyin API frequently asked questions
What are the Douyin APIs?
The Douyin APIs retrieve public profiles, videos, comments, video search results, and live-room details as normalized records.
Which endpoints accept results_limit?
User Videos and Video Comments accept an integer from 1 to 20. The other Douyin endpoints reject results_limit.
Can I page the source?
No caller-controlled source cursor is available. A returned next_cursor only pages results already stored for the completed task.
How are Douyin requests priced?
Each successful task costs a fixed 0.10 SocQ credits.
Combine data across platforms for more complete business insights
Bring public profiles, content, and engagement data from different platforms into one workflow to track brands, creators, and topics and run cross-platform monitoring and analysis more efficiently.
Instagram API
Look up or find public profiles and collect follower-list records, following relationships, authored posts, profile-tagged posts, hashtag results, Reels, transcripts, comments, account counts, engagement metrics and media metadata through one asynchronous workflow.
YouTube API
Collect supported public YouTube channel profiles, video details, channel videos, comments, Shorts, keyword and hashtag results, and available transcripts through one normalized asynchronous workflow.
X API
Collect public profiles, follower and following relationships, posts, replies, quotes, retweeters, search results, and current trends. Use consistent results for research and monitoring.
Facebook API
Collect public Facebook Page profiles, posts, group posts, comments, keyword-matched events, and available video transcripts with normalized identity, content, source, format, place, media, reaction, attendance, and engagement fields.
Google Ad Library API
Discover public advertisers, collect creatives for a company, or retrieve one known Transparency Center creative by URL for research and review.
Google Maps API
Discover public places, retrieve normalized details for known Maps URLs, and collect public reviews with source-linked place and author context.