SuperAPI AI Directory

douyin-rise-ranking

General & other

View repository

Updated 10-16 08:41

About this skill

Douyin Follower Growth Account Ranking · Dark-Horse Creators (Dubaoya)

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 form dyh_…)。


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 --date back 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 riseFans field; 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)

  1. Open doubaoya.com
  2. Log in
  3. Go to Token Center
  4. 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, enum day / week / month, default week
    • rankDate: String YYYY-MM-DD, default yesterday
    • category: 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)
    • rankDate Please 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 is true do you read data; otherwise read error.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_FAILED will 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