douyin-rise-ranking

Douyin Follower-Growth Account Recommendations

Overview

Douyin Follower-Growth Account Recommendations is an intelligent tool focused on querying Douyin follower-growth data, helping users track the follower growth rankings of accounts in various fields in real time.

With this tool, you can:

📊 Get the daily/weekly/monthly Douyin follower-growth TOP50 rankings
🔍 Precisely filter by 27 vertical fields (food, technology, beauty, etc.)
📈 Automatically generate a three-dimensional follower-growth analysis report (follower-growth trend overview + growth pattern analysis + operational insight recommendations)
🔔 Subscribe to scheduled push notifications, with data delivered automatically

Suitable for scenarios such as creators, brands, MCN agencies, and operations personnel who need to monitor Douyin follower-growth trends.

Features

🎯 Core Features

📊 Multi-dimensional time rankings: Supports three time dimensions: daily ranking/weekly ranking/monthly ranking, covering the needs of different operational cycles
🔍 27 vertical categories: From food to gaming, precisely filter the follower-growth rankings of target tracks by field
📈 Three-dimensional follower-growth analysis: Follower-growth trend overview (4 quantitative indicators) + growth pattern analysis (3-layer tiered comparison) + operational insight recommendations (3 types: benchmark/potential/risk)
🔔 Scheduled subscription push: One-click subscription to daily/weekly/monthly rankings, automatically delivered at update times

✨ Highlights

⚡ Real-time updates: Daily ranking updates every day at 18:00, weekly ranking updates every Monday at 18:00, monthly ranking updates on the 3rd of each month at 18:00
🏆 Visual presentation: TOP3 gold, silver, and bronze medal identifiers, with account names containing clickable jump links
📱 In-depth insights: Three-stage analysis based on full TOP50 data (follower-growth trend overview → growth pattern analysis → operational insight recommendations)
🔒 Secure and convenient: Only requires an API Key, no account or password needed, and data is obtained through standardized interfaces

One-click Installation

Prerequisites

Already registered Honghu Hub Official Website account
Go to registration page to register; new users can receive free credits
Get the API Key in the personal center, in the format ak_xxxxxxxx

Environment Variable Configuration

Variable Name	Required	Description
`REDFOX_API_KEY`	Yes	Honghu Hub API access key, format `ak_xxxxxxxx`

Configuration Method

macOS/Linux：

export REDFOX_API_KEY=<你的apikey>
echo 'export REDFOX_API_KEY=<你的apikey>' >> ~/.bashrc
source ~/.bashrc

Windows：

[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<你的apikey>", "User")

After configuration is complete, verify:

macOS/Linux：echo $REDFOX_API_KEY
Windows：echo %REDFOX_API_KEY%

Usage Guide

Basic Usage

1. Query the daily follower-growth ranking

Just directly state the category you want to query; no need to specify the daily ranking (default):

User: Check the Douyin follower-growth ranking for the food category

Assistant: Automatically matches the "Food" category, outputs the daily ranking TOP20 + three-dimensional follower-growth analysis + subscription prompt

User: Today's follower growth

Assistant: Retrieve the latest daily ranking for all categories

2. Query the weekly or monthly ranking

Specify the time dimension when querying:

User: This week's tech category follower growth ranking

Assistant: Automatically uses weekly ranking data, matching the "Digital Technology" category

User: This month's beauty category follower growth ranking

Assistant: Automatically uses monthly ranking data, matching the "Makeup & Beauty" category

3. View more rankings

By default, TOP20 is displayed. Reply "View more" to get the remaining 30 entries from TOP21-50.

4. Subscribe to scheduled push notifications

After the query is completed, subscription options will be prompted. Reply with a number:

Number	Function	Push time
1	Subscribe to daily ranking	Daily at 18:00
2	Subscribe to weekly ranking	Every Monday at 18:00
3	Subscribe to monthly ranking	The 3rd of each month at 18:00
4	Subscribe to all	Daily/weekly/monthly all pushed
5	Do not subscribe for now	—

You can also directly say "Subscribe to daily ranking," "Subscribe to weekly ranking," "Subscribe to monthly ranking," or "Subscribe to all."

Advanced usage

Automatically match categories by keyword

Supports using keywords instead of exact category names, and the system automatically matches:

Your input keyword	Automatically matched category
Phone/Computer/AI	Digital Technology
Food/Cooking/Store visits	Food
Outfits/Fashion/Trends	Trend & Style
Fitness/Sports/Weight loss	Physical Exercise
Skincare/Makeup/Beauty	Makeup & Beauty
Games/Esports/Mobile games	Games
Pets/Cats/Dogs	Animals
Dancing/Dance	Dance Talent
Singing/Music	Music

Complete list of available categories (27)

All, Personal Talent, Lifestyle Vlog, Wealth & Finance, ACG, Home Decoration, Education & Learning, Short Theater, Digital Technology, Travel, Food, Makeup & Beauty, Animals, Parenting, Automotive, Relationships, Agriculture & Rural, Health & Medicine, Trend & Style, Dance Talent, Appearance & Styling, Humanities, Music, Film & TV, Physical Exercise, Sports, Celebrity & Entertainment, Games

Data lookback range

Ranking type	Lookback range	Update rule
Daily ranking	Last 7 days	Updated daily at 18:00 with the previous day's data
Weekly ranking	Last 3 weeks	Updated every Monday at 18:00 with the previous week's data
Monthly ranking	Last 3 months	Updated on the 3rd of each month at 18:00 with the previous month's data

💡 Complete execution process(including format templates, operation steps, date judgment logic, API parameters, etc.) please refer to references/core_workflow.md。

Use cases

Scenario 1: Brand competitor monitoring

Role: Brand marketing manager

Needs: Track the follower growth performance of brand accounts in the same track and understand competitors' marketing rhythm

How to use：

Query the daily/weekly follower growth ranking for the category the brand belongs to
Compare your own follower growth rate and increment against competitors
Adjust marketing rhythm based on trending topic analysis

Expected benefits: Capture industry follower growth trends and optimize brand marketing strategy

Scenario 2: Content Creator Topic Reference

Role: Douyin creator

Needs: Understand follower growth hotspots in the niche and gain topic inspiration

How to use：

View the follower growth ranking and trending topic analysis for your category
Analyze the follower growth characteristics of top accounts (relationship between follower growth rate and follower base)
Plan content directions based on trending events

Expected benefits: Find follower growth directions and improve content competitiveness

Scenario 3: MCN Agency Talent Management

Role: MCN operations personnel

Needs: Monitor follower growth data of managed talents and benchmark accounts in batches

How to use：

Query weekly/monthly rankings by category
Compare the follower growth gap between managed talents and industry leaders
Use trending topic analysis to optimize talent operation strategy

Expected benefits: Data-driven talent operation decisions, promptly discover potential accounts

Scenario 4: Ad Placement and Account Selection Reference

Role: Advertising / business personnel

Needs: Screen high-growth-potential accounts for collaborative ad placement

How to use：

Query small and medium-sized accounts with high follower growth rates in the monthly ranking
Use three-dimensional follower growth analysis to judge growth sustainability
Lock onto collaboration targets and reduce account selection risk

Expected benefits: Precise account selection, improve ad placement ROI

Project Architecture

Directory Structure

douyin-rise-ranking/
├── SKILL.md                         # Skill 说明文档（本文件）
├── scripts/
│   └── gzh_growth_fetcher.py        # 核心数据获取脚本
└── references/
    ├── core_workflow.md             # 核心执行流程（格式模板、操作步骤）
    └── dy-rank-api.md               # API 接口规范

Tech Stack

Project	Description
Runtime Environment	Python 3.10+
Data Source	Honghu Hub Douyin Follower Growth Ranking API
Authentication Method	`REDFOX_API_KEY` Environment Variables
Data Cache	`~/.workbuddy/cache/dy_rise_ranking_data.json`

Core Modules

Module	Path	Responsibility
Data Retrieval	`scripts/gzh_growth_fetcher.py`	Call the API to retrieve follower growth ranking data, supporting category/keyword/date parameters
Execution Flow	`references/core_workflow.md`	Complete operation steps, format templates, Checklist, date judgment logic
API Specification	`references/dy-rank-api.md`	Interface parameter definitions, return field descriptions, call examples

FAQ

Installation and Configuration

Q1: What should I do if it says the API Key is invalid?

A: Please check:

Whether the Key format is ak_xxxxxxxx
Confirm it has been activated on the Honghu Hub official website
Check whether there are extra spaces before or after the Key

Q2: How do I verify that the API Key configuration is successful?

A: On Windows, run echo %REDFOX_API_KEY%, on macOS/Linux run echo $REDFOX_API_KEY, and confirm that the correct Key value is output.

Usage-related

Q3: Which categories are supported?

A: 27 categories in total: All, Personal Talent, Lifestyle Vlog, Wealth & Finance, ACG, Home Decoration, Study & Education, Short Skits, Digital Tech, Travel, Food, Makeup & Beauty, Animals, Parenting, Automotive, Relationships, Agriculture, Health & Medicine, Trends & Fashion, Dance Talent, Looks & Styling, Humanities, Music, Film & TV, Fitness, Sports, Celebrity & Entertainment, Games.

Q4: How often is the data updated?

A: The daily ranking updates the previous day's data every day at 18:00, the weekly ranking updates the previous week's data every Monday at 18:00, and the monthly ranking updates the previous month's data on the 3rd of each month at 18:00.

Q5: How far back can I query data?

A: The daily ranking can go back up to 7 days, the weekly ranking up to 3 weeks, and the monthly ranking up to 3 months. If the range is exceeded, it will automatically adjust to the nearest available date.

Q6: How many records are returned per query?

A: By default, TOP20 + follower growth analysis is displayed. Reply "View more" to get the remaining 30 records (TOP50 in total).

Q7: How do I subscribe to scheduled push notifications?

A: After the query is completed, subscription options will be displayed. Reply with a number from 1 to 5. You can also directly say "Subscribe to daily ranking", "Subscribe to weekly ranking", etc.

Troubleshooting

Q8: Data is not updating or the query fails?

A: Troubleshoot by following these steps:

Check whether REDFOX_API_KEY has expired
Confirm whether the current time is past the ranking update time (all update at 18:00)
Confirm that the query date is within the allowed lookback range

Get Help

If you have other questions, you can contact us through the following methods:

📧 Email:redfoxdata@proton.me

About this skill

Overview

Features

🎯 Core Features

✨ Highlights

One-click Installation

Prerequisites

Environment Variable Configuration

Configuration Method

Usage Guide

Basic Usage

1. Query the daily follower-growth ranking

2. Query the weekly or monthly ranking

3. View more rankings

4. Subscribe to scheduled push notifications

Advanced usage

Automatically match categories by keyword

Complete list of available categories (27)

Data lookback range

Use cases

Scenario 1: Brand competitor monitoring

Scenario 2: Content Creator Topic Reference

Scenario 3: MCN Agency Talent Management

Scenario 4: Ad Placement and Account Selection Reference

Project Architecture

Directory Structure

Tech Stack

Core Modules

FAQ

Installation and Configuration

Usage-related

Troubleshooting

Get Help