📝 Overview
Daily content popularity monitoring tool, manually collects and verifies ten-thousand-level Douyin works across the entire platform every day, and outputs a single-day likes TOP50 ranking.
- Update time: updates yesterday's data daily at 06:00
- Backtracking range: up to the past 30 days
- Each category returns at most 50 items
✨ Features
| Feature Module | Capability Description | Core Value |
|---|---|---|
| Daily Ranking | Outputs a single-day likes TOP50 ranking daily | Quickly obtain the hottest works of the day across the entire platform |
| Track Filtering | Supports querying 28 track categories | Precisely locate popular content in vertical fields |
| Historical Backtracking | Supports backtracking data from the past 30 days | Trace past popular trends |
| Clickable Links | Work titles are output in hyperlink format | One-click jump to view the original work |
| Paginated Display | Default TOP20, can view the complete TOP50 | Obtain full or summary data on demand |
| Subscription Push | Supports subscription by track and time preferences | Get popular updates on a scheduled basis |
🔑 Authentication
Get API Key
Please go to Redfox Hub to get the API KEY
Configure API Key
Option 1: Taking OpenClaw as an example, add REDFOX_API_KEY to ~/.openclaw/openclaw.json, some contents are as follows:
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
Option 2: Terminal configuration
export REDFOX_API_KEY="ak_xxxx..."
📡 API Call
- Endpoint Address：
POST https://redfox.hk/story/api/dy/search/likesRank - Authentication Method: request header
X-API-KEY, value obtained from environment variableREDFOX_API_KEYRetrieve - Fixed Parameters：
source(values see script) - Optional Parameters：
type(track),startTime、endTime(date range)
See api-config.md。
🔄 Interaction Flow
1. Time Judgment
| User Input | Handling Method |
|---|---|
| Today / Current / Latest | Reply explaining that the latest is yesterday, provide yesterday's data |
| Future Date | Reply with a prompt, provide yesterday's data |
| Historical date within 30 days | Directly query the corresponding date |
| More than 30 days ago | Reply with a prompt, provide the data closest to the time range |
Time prompt:
- Current day/future: "We are very sorry🙏, our latest data is yesterday's data, and we will provide you with yesterday's hot ranking closest to your needs."
- Out of range: "We're very sorry 🙏, currently the leaderboard supports looking back at most the "past 30 days". I will query the time range closest to your needs for you~"
2. Track determination
Classify the user's description into the following supported tracks. If no match is found, clearly inform the user and list all tracks, then ask the user to choose:
全部、小剧场、财富理财、二次元、身体锻炼、居家装修、数码科技、科学普及、
旅行、美食、动物、明星娱乐、汽车、亲子、人文、三农、潮流风尚、游戏、
生活记录、体育、舞蹈才艺、学习教育、休闲玩乐、影视、音乐、颜值造型、
健康医学、综艺、个人成长
3. Default behavior
Unless otherwise specified, return yesterday's all-category daily leaderboard by default.All queries (including all-category and specific tracks) display TOP20 by default. Only when the user explicitly requests to view the complete leaderboard, output all 50 records.
📊 Standard output format
The leaderboard is presented as a Markdown table,The work title must use the [标题](workUrl) format to output as a clickable hyperlink：
💡 榜单说明：每日 06:00 更新昨日数据，[如有时间偏差提示则插入]。互动数据为入库时间，与实时数据存在差异。
📊 抖音每日点赞TOP20（YYYY-MM-DD）[查询全部时含"赛道"列，查询特定赛道时不含]
| 排名 | 作品标题 | 作者（粉丝数） | 赛道* | 收藏 | 评论 | 分享 | **点赞** | 发布时间 |
|------|---------|--------------|-------|------|------|------|------|---------|
| 1 | [红烧肉的教程](https://www.douyin.com/video/xxx) | 美食达人（10w+） | 美食 | 10w+ | 10w+ | 10w+ | **10w+** | 05-28 12:00 |
*查询特定赛道时去掉"赛道"列
⚡ 更多操作
• 本次榜单完整共50条数据，是否需要查看剩余30条？
📬 订阅服务
1️⃣ 我们每日 06:00 更新昨日数据，是否需要订阅每日的抖音作品最新排名，订阅后定时推送给您
2️⃣ 是否需要订阅具体赛道的作品表现？我们支持：[列出28个赛道]
> 💼 另外红狐配套全量数据库可提供完整详实数据，如需了解采购方案，可前往红狐hub[企业服务](https://redfox.hk/dashboard/enterprise)对接咨询
Work title hyperlink specification (must be followed)
- Work titlemustbe output in Markdown link format:
[作品标题](workUrl) workUrlis a field returned by the API, and is the work's access link on Douyin- ProhibitedUse HTML
<a>tags or terminal OSC escape sequences - Even if the terminal does not support direct clicking, the Markdown link format can still ensure that the chat interface correctly renders it as a clickable hyperlink
Data field description
| Field | Source field | Description |
|---|---|---|
| Rank | rank | Same-day like ranking |
| Work title | video_title + workUrl | Must be displayed as [标题](workUrl) hyperlink format |
| Author | author_name + author_fans | Account name + total followers |
| Track | category | Displayed only for all-category queries |
| Favorites / Comments / Shares / Likes | collect / comment / share / like | Interaction data (snapshot at ingestion time),The values in the likes column must be displayed in bold |
| Publish time | publish_time | Format MM-DD HH:00 |
📬 File output and subscription
- Display 20 records by default; when the user requests the full version, output a Markdown table (including 50 records)
- Subscription: supports users selecting tracks and time preferences, with automatic push after the daily 06:00 update
📚 Other resources
- API configuration and invocation:api-config.md
- Track classification and interaction examples:interaction-guide.md