SuperAPI AI Directory
Partner中文AI newsFavorites
Skillsdouyin-top-account

douyin-top-account

Data & analytics

View repository

Updated 10-16 08:41

About this skill

Douyin Influential Account Ranking · Top Big Accounts (Dubaoya)

This duck helps you pull by dateDouyin Most Influential Account Ranking—See at a glance which big accounts are leading and which track is hottest, and casually judge Douyin's current traffic trends.

Data goes through doubaoya.com one line, authentication uses your own token (environment variable DOUBAOYA_API_KEY, in the form dyh_…）。

Use Cases

Scenario How to Use What You Get
See the top-tier landscape Pull the latest influence ranking to see who is leading A list of top big accounts
Traffic trends See which tracks high-influence accounts are concentrated in The current real traffic trends
Find benchmark accounts Lock onto top players in the same track to study their tactics Transferable content strategies
Periodic quick scan Scan the ranking by day/week/month Top list for the period

Workflow (4 steps)

1. Set dimensions + date

First setranking dimension（--period：day daily ranking / week weekly ranking / month monthly ranking, default weekly) andindustry category（--category, default "All"). 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_top_account.py"

Specify dimensions and date:

python3 "$SKILL_PATH/scripts/fetch_top_account.py" --period month --date 2026-06-25 --category 全部

The script prints the data from the success envelope as JSON to stdout.Run the script only once each time, read the complete stdout, don't use head/tail 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 ranking table

From data.items take rank (position)、accountName (account name)、influenceScore (influence index) and other fields (read defensively, leave blank if missing), lay them out as a Markdown table in ascending rank order:

Rank Account Influence Index
1 Some Account xxxx

For influence metrics read the influenceScore field, externally displayed uniformly as "Influence Index".

4. Give one sentence of trend insight

After the table, add one sentence in this duck's tone: which tracks these top big accounts are concentrated in, what content formats they used to lead, and which tactics can be transferred to your own account or other platforms. Brief, useful, don't pile on clichés.

Get the key (token)

  1. Open doubaoya.com
  2. Log in
  3. go to Token Center
  4. Generate Token(in the form dyh_…）

Configure it into an environment variable (the script only recognizes this one):

export DOUBAOYA_API_KEY="dyh_你的口令"

Ironclad rule: the token is never printed, never written to a file, and never echoed 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-top-account/call
  • Auth header:Authorization: Bearer $DOUBAOYA_API_KEY
  • Request body:{ "period": "week", "rankDate": "2026-06-26", "category": "全部" }
    • period: ranking period, enum day / week / month, default week
    • rankDate: string YYYY-MM-DD, default yesterday
    • category: industry classification, default 全部
    • rankDate Please pass areal, relatively recent date(the most recent date for the region), do not fabricate or fill in a future date; an empty result usually means there is no data for that date window yet, so move back one day and try again.
  • Return envelope: 
    { "success": true, "requestId": "...", "data": { "items": [ { "rank": 1, "accountName": "...", "influenceScore": "..." } ] }, "error": null }
  • First check success: if it is true then 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 or invalid token Check DOUBAOYA_API_KEY, go to the token center to regenerate
400 VALIDATION_ERROR Invalid parameter (e.g., wrong date format) Fix --date / --period and retry
— NO_DATA No ranking for that day Try a different 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 (automatically refunded） Safe to retry

502 PROVIDER_FAILED automatically refunds, retrying is safe, and you will not be charged twice.

Directory structure

douyin-top-account/
├── SKILL.md                    # 本文件
└── scripts/
    └── fetch_top_account.py    # 零依赖脚本（urllib），调用 doubaoya.com