This Duck helps you pull by dateDouyin follower growth ranking—specifically selecting the "dark-horse creators" who have gained followers most rapidly recently, letting you see at a glance who is rising and which track is surging, and conveniently judge Douyin's follower growth trends.
Data runs through doubaoya.com one line, authentication uses your own token (environment variable
DOUBAOYA_API_KEY, in the formdyh_…)。
Applicable scenarios
| Scenario | How to use | What you get |
|---|---|---|
| Discover dark horses | Pull the latest follower growth ranking to see who is surging | A batch of high-growth dark-horse creators |
| Follower growth trends | See which tracks the follower-growing accounts are concentrated in | The real current follower growth trends |
| Benchmark rising accounts | Find creators who are ramping up and study their tactics | Transferable follower growth strategies |
| Category treasure hunting | Lock onto dark horses in segmented tracks by industry category | Potential creators in segmented tracks |
Workflow (4 steps)
1. Set dimensions + date
First setranking period(--period:day daily ranking / week weekly ranking / month monthly ranking, default weekly ranking) andindustry category(--category, default "All"; common options include Digital Tech / Food / Makeup & Beauty / Agriculture, Rural Areas & Farmers / Emotional / Gaming, etc.). Date defaults to pullingyesterday(same-day data is usually not yet settled),--date accepts a specific YYYY-MM-DD。
2. Call the script
python3 "$SKILL_PATH/scripts/fetch_rise_rank.py"
Specify dimensions and category:
python3 "$SKILL_PATH/scripts/fetch_rise_rank.py" --period week --date 2026-06-25 --category 美食
The script outputs the data in the success envelope as JSON to stdout.Run the script only once each time, read the complete stdout, do not use head/tail to preview.
When encountering "no data for the specified day", you can have the main Agent proactively move
--dateback one day and run again until data is obtained.
3. Render the follower growth ranking table
From data.items , take rank (ranking)、accountName (account name)、riseFans (follower increment) and other fields (read defensively, leave blank if missing), lay them out as a Markdown table, sorted by ranking ascending:
| Ranking | Account | Follower increment |
|---|---|---|
| 1 | Some Creator | +xxx |
Read the follower increment from the
riseFansfield; display it externally as "follower increment".
4. Give a one-sentence trend insight
After the table, add one sentence in this Duck's tone: which tracks these dark-horse creators are concentrated in, what content formats or hot topics they leveraged to rise, and which follower growth tactics can be transferred to your own account or other platforms. Brief, useful, and don't pile on empty talk.
Get the key (token)
- Open doubaoya.com
- Log in
- Go to Token Center
- Generate Token(format like
dyh_…)
Configure into environment variable (the script only recognizes this one):
export DOUBAOYA_API_KEY="dyh_你的口令"
Iron rule: never print the token, never write it into a file, never echo it back to the user. The script itself also never outputs the token. All requests are sent only to doubaoya.com。
Interface and Envelope
POST https://doubaoya.com/api/apis/douyin/douyin-rise-fans-rank/call- Auth header:
Authorization: Bearer $DOUBAOYA_API_KEY - Request body:
{ "period": "week", "rankDate": "2026-06-26", "category": "全部" }period: Leaderboard period, enumday/week/month, defaultweekrankDate: StringYYYY-MM-DD, default yesterdaycategory: Industry category, default全部(there are also multiple optional niche tracks such as Digital Tech / Food / Makeup and Beauty / Agriculture, Rural Areas and Farmers / Relationships / Gaming)rankDatePlease passa real, relatively recent date(the most recent date in the local region); do not fabricate or fill in a future date. An empty result usually means there is no data for that date window yet; move back one day and try again.
- Return envelope:
{ "success": true, "requestId": "...", "data": { "items": [ { "rank": 1, "accountName": "...", "riseFans": "..." } ] }, "error": null } - First check
success: only when it istruedo you readdata; otherwise readerror.code/error.message。
Error Handling
When the script fails, it prints to stderr [error] CODE: message and exits with code 1. Common cases:
| HTTP | code | Meaning | Handling |
|---|---|---|---|
| 401 | MISSING_API_KEY / UNAUTHORIZED |
No token provided or token invalid | Check DOUBAOYA_API_KEY, go to the Token Center to regenerate |
| 400 | VALIDATION_ERROR |
Invalid parameter (e.g., wrong date format) | Correct --date / --period and retry |
| — | NO_DATA |
No leaderboard for that day | Change the date, or confirm the data window |
| 402 | INSUFFICIENT_CREDITS |
Insufficient quota | Go to doubaoya.com to top up/renew quota |
| 502 | PROVIDER_FAILED |
Temporary upstream failure (automatic refund already issued) | safe to retry |
502 PROVIDER_FAILEDwill automatically refund; retrying is safe and will not result in duplicate charges.
Directory Structure
douyin-rise-ranking/
├── SKILL.md # 本文件
└── scripts/
└── fetch_rise_rank.py # 零依赖脚本(urllib),调用 doubaoya.com