douyin-scraper-api
Pull Douyin videos, user profiles and feeds, comments, hashtags, music, live rooms, the hot-search board, keyword search across videos, users, music and hashtags, and live-room lookup by creator. 27 endpoints, structured JSON.
scavio-ai · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add scavio-ai/skills --skill douyin-scraper-api技能说明
name: douyin-scraper-api description: Pull Douyin videos, user profiles and feeds, comments, hashtags, music, live rooms, the hot-search board, keyword search across videos, users, music and hashtags, and live-room lookup by creator. 27 endpoints, structured JSON. version: 1.0.0 tags: douyin, douyin-api, china-tiktok, short-video, social-media-data, creator-data, video-data, comments, hashtags, trending, live-stream, china-market, influencer-data, agents, structured-data, json, ai-agents, scraping-api metadata: openclaw: requires: env: - SCAVIO_API_KEY primaryEnv: SCAVIO_API_KEY timeout: 120 throttle: 1 emoji: "\U0001F3B5" homepage: https://scavio.dev/docs?utm_source=agent-skills&utm_medium=skill&utm_campaign=douyin-scraper-api
Douyin Scraper API - Videos, Creators, Comments, Search
Pull Douyin (the Chinese TikTok) videos, user profiles and feeds, comments, hashtags, music, live rooms, the hot-search board, run keyword search across videos, users, music and hashtags, and find which creators are live. All endpoints return structured JSON.
When to trigger
Use this skill when the user asks to:
- Pull a Douyin video's full detail or statistics (play, like, share, download counts), or resolve a share link
- Read a user's profile, their posts, their liked videos, followers or following, or their current live stream
- Read a video's comments and comment replies, or videos recommended alongside it
- Look up a hashtag or a sound (music) and the videos under it
- Read the hot-search board, the recommended home feed, or a live room by
web_ridorlive.douyin.comURL - Search Douyin by keyword - general, or scoped to videos, users, music or hashtags
- Find a creator's live room by nickname or Douyin ID, with live status, room id and stream title
- Do China-market social research, creator analysis or trend spotting on Douyin
Setup
Get a free API key at scavio.dev (50 free credits to get started, no card required):
export SCAVIO_API_KEY=sk_live_your_key
If you do not have a key yet
An agent running this skill without SCAVIO_API_KEY set will get 401 on every
call below. The whole path from nothing to a working key is self-serve:
- Sign up at dashboard.scavio.dev - email or Google, no card required.
- A key is created for the account automatically at signup. It is on the dashboard under API Keys, ready to copy.
- A new account starts with 50 credits. Endpoints in this skill cost 1 credit each unless the table below says otherwise.
When the balance runs out the API answers 402 with a JSON body carrying
billing_url. Topping up needs no code change - the same key keeps working.
The smallest purchase is 2,500 credits for $25, and monthly plans work out
cheaper per credit if the usage is steady rather than one-off.
Every request is a POST with a JSON body and:
Authorization: Bearer $SCAVIO_API_KEY
Pricing
Base URL: https://api.scavio.dev.
- Search endpoints (
/api/v1/douyin/search*) cost 10 credits each. - Every other Douyin endpoint costs 1 credit.
Check credits_used on each response to confirm what a call cost.
Endpoints
Video
| Endpoint | Credits | What it returns |
|---|---|---|
POST /api/v1/douyin/video | 1 | Full detail for a single video by id |
POST /api/v1/douyin/video/by-share-url | 1 | Resolve a share link to its video detail |
POST /api/v1/douyin/video/statistics | 1 | Play, like, share and download counts for one or more videos |
POST /api/v1/douyin/video/comments | 1 | Top-level comments on a video |
POST /api/v1/douyin/video/comment-replies | 1 | Replies under a comment |
POST /api/v1/douyin/related | 1 | Videos recommended alongside a given video |
User
| Endpoint | Credits | What it returns |
|---|---|---|
POST /api/v1/douyin/user/profile | 1 | Profile details for a user |
POST /api/v1/douyin/user/posts | 1 | A user's published videos |
POST /api/v1/douyin/user/likes | 1 | A user's publicly liked videos |
POST /api/v1/douyin/user/followers | 1 | A user's followers |
POST /api/v1/douyin/user/following | 1 | Accounts a user follows |
POST /api/v1/douyin/user/live | 1 | A user's current live stream |
Hashtag / music / live
| Endpoint | Credits | What it returns |
|---|---|---|
POST /api/v1/douyin/hashtag | 1 | Details for a hashtag |
POST /api/v1/douyin/hashtag/videos | 1 | Videos under a hashtag |
POST /api/v1/douyin/music | 1 | Details for a sound |
POST /api/v1/douyin/music/videos | 1 | Videos using a sound |
POST /api/v1/douyin/live/room | 1 | Live room detail (title, status, viewers, stream URLs, anchor) by web_rid or live_room_url |
Trending / feed / resolve
| Endpoint | Credits | What it returns |
|---|---|---|
POST /api/v1/douyin/trending | 1 | The current hot-search board |
POST /api/v1/douyin/home-feed | 1 | The recommended home feed |
POST /api/v1/douyin/resolve/video-id | 1 | Extract a video id from a Douyin URL |
POST /api/v1/douyin/resolve/user-id | 1 | Extract a user sec_user_id from a Douyin URL |
Search (10 credits each)
| Endpoint | Credits | What it returns |
|---|---|---|
POST /api/v1/douyin/search | 10 | General keyword search |
POST /api/v1/douyin/search/videos | 10 | Search videos by keyword |
POST /api/v1/douyin/search/users | 10 | Search users by keyword |
POST /api/v1/douyin/search/music | 10 | Search sounds by keyword |
POST /api/v1/douyin/search/live | 10 | Live rooms by creator nickname or Douyin ID (is_live, room_id, title); pages with cursor |
POST /api/v1/douyin/search/hashtags | 10 | Search hashtags by keyword |
Key identifiers
aweme_id- a video id (e.g. `74366135