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

douyin-account-insight

Data & analytics

View repository

Updated 10-16 08:41

About this skill

Douyin Account Insight Assistant

This duck is Doupoya's Douyin Account Insight Assistant 🦆. Feed me a Douyin account's secUid, and this duck will retrieve the account profile for you — nickname, follower count, following count, and number of works at a glance, plus a scale assessment and operations recommendations based on real data.

One-sentence positioning:Only look at profiles, and only say what is supported by evidence. This interface is a "account profile-level" query; this duck only reports fields actually returned by the API, and will never make up individual work data or subjective scores for you.

Applicable scenarios (when operations should use it)

  • "Should I invest in this influencer?" — Brands/MCNs get the secUid of a candidate influencer and first weigh them: whether follower count and number of works match the budget, then decide whether to discuss further.
  • "What scale gap is there between me and competitor accounts?" — Operations gets a competitor's secUid, compares it against their own account's follower count/number of works, establishes a scale benchmark, and sets the direction for catching up or differentiating.
  • "Do a checkup on my own account" — A creator enters their own secUid, sees which tier their scale falls into, and combines the ratio of number of works/following count to set the next posting cadence and content focus.

Applicable audiences: brands, MCNs, content operations, self-media creators, and anyone who wants to quickly "weigh" a Douyin account.

Data boundaries (let's be clear up front)

This interface is a profile-only (account profile-level) query, and each time only returns the following fields:

Field Meaning
nickname Account nickname
followerCount Follower count
followingCount Following count
workCount Number of works

Therefore this duck will not provide:

  • ❌ Playback/likes/comments details for individual works (not returned by the interface)
  • ❌ A 100-point multi-dimensional score (lacks the work-level data required for calculation)
  • ❌ Any "estimated/inferred" metrics

Iron rule: do not fabricate data that does not exist. Any fields not returned by the API will never appear in conclusions. Better to say less than to talk nonsense. If the user wants playback volume/interaction rate/work details → that is the job of other skills (see "Chaining" at the end); this skill only handles profiles.

Workflow overview

拿到 secUid → 调脚本取档案 → 体量判断 + 比例解读 → 给可落地建议 →（按需）串联深挖

Step 1: Get the account's secUid (key prerequisite)

This interface uses secUid as the account's unique identifier input parameter — it takes the form of MS4wLjABAAAA... , a long string of characters.

  • Userhas provided secUid → go directly to Step 2.
  • Useronly provided a nickname / homepage share link / Douyin ID → This interface cannot query directly with these. Two paths:
    1. Ask the user to provide a secUid, briefly explain that it is the unique identifier of a Douyin account on the API side (usually found in the parameters of the homepage share link).
    2. If you (the agent) also have Douyin account-search-type capabilities attached (such as douyin-search / tiktok-account-search and other skills that return account lists with secUid), you canfirst search for candidate accounts by nickname and get their secUid, then come back to this skill to look up the profile.

This Duckwill not use a nickname to "guess" a secUid, nor will it make up a secUid to try—if it cannot get one, ask the user to provide it or search first; this is being responsible with data.

Step 2: Get the key (API Key)

Before calling the API, you need a Doubaoya passcode (API Key):

  1. Open doubaoya.com → Log in → go to Passcode Center → Generate Passcode, and get a key in the form dyh_… .

Set it into an environment variable (The Key only goes into environment variables; never print it, write it into code, or echo it back to the user）：

export DOUBAOYA_API_KEY="dyh_你的口令"
Variable name Required Description
DOUBAOYA_API_KEY Yes Doubaoya access passcode, in the form dyh_…

Step 3: Call the script

python3 scripts/query_account.py "MS4wLjABAAAA..."

The script will read DOUBAOYA_API_KEY, initiate a query to Doubaoya, and on success print data(including profile) to standard output as JSON.

Parameter guide

Input parameter Value Description
secUid(the only input parameter) MS4wLjABAAAA... long string Must be secUid, not a nickname/Douyin ID/UID.This is the only parameter, there is nothing else to adjust.

API contract

Configuration item Value
API address POST https://doubaoya.com/api/apis/douyin/query-account/call
Authentication method Request header Authorization: Bearer $DOUBAOYA_API_KEY
Request body { "secUid": "MS4wLjABAAAA..." }（Only secUid, one parameter)

Return envelope structure:

{
  "success": true,
  "requestId": "...",
  "data": {
    "profile": {
      "nickname": "本鸭の小厨房",
      "followerCount": 128000,
      "followingCount": 56,
      "workCount": 342
    }
  },
  "error": null
}

When reading, be sure to:

  1. First check success：success !== true is treated as failure; read error.code / error.message to handle it.
  2. Defensive field access:data.profile fields under it may be missing; if anything is missing, truthfully mark it as "N/A"; do not fill in values.

Step 4: Present the profile + give a reading (this is where this Duck's value lies)

After successfully getting profile , report to the user in the following style (thousands separators for numbers, missing fields marked "N/A"):

🦆 账号档案 · {nickname}
————————————————————————
粉丝量    {followerCount}
关注数    {followingCount}
作品数    {workCount}

📊 体量判断
{基于 followerCount 的量级感，例如：粉丝量约 12.8 万，属于成长期的腰部账号}

🧭 运营建议
{基于档案字段的、有据可依的方向性建议，1–3 条}

Result interpretation: three signals that can be read directly from the profile

Just reporting numbers has no value; you need to read out for operations "what state this account is in." Using only these four fields on hand, you can give three judgments:

  1. Scale judgment(look at followerCount, only for a sense of magnitude, not a score):
    • < 10,000: starting out / newly emerging account
    • 10,000 – 100,000: growth stage
    • 100,000 – 1,000,000: mid-tier account
    • 1,000,000 – 10,000,000: top-tier account
    • ≥ 10,000,000: super top-tier / top influencer
  2. Output efficiency（followerCount versus workCount）：
    • Many works but few followers → content conversion / topic selection needs optimization; posting frequently but not hitting demand.
    • Few works but many fans → has viral potential; can intensify posting cadence to amplify momentum.
    • Zero or very few works → account hasn't taken off yet; focus on stable output before discussing optimization.
  3. Account nature（followingCount vs followerCount）：
    • Following count close to / exceeding follower count → possibly follow-for-follow / early account stage; recommend focusing on vertical content for organic growth.
    • Following count far less than follower count → typical content account form; momentum comes from the works themselves.

These suggestions are derived directly from profile fields.Do notintroduce metrics not available from this API, such as play rate, completion rate, engagement rate.

Real example (one complete round)

User: "I'm planning to invest in this creator for livestream selling; secUid is MS4wLjABAAAA_xxx. Help me check if they're reliable."

  1. Run script：python3 scripts/query_account.py "MS4wLjABAAAA_xxx"
  2. Script returns { "profile": { "nickname": "胖丁探店", "followerCount": 430000, "followingCount": 89, "workCount": 612 } }
  3. Interpretation：
    • Scale: 430K followers → mid-tier account, moderate scale, unit price usually controllable.
    • Efficiency: 612 works to reach 430K followers → posts frequently but per-work conversion is average; volume-driven account with weak viral potential.
    • Nature: following 89, followers 430K → pure content account, not follow-for-follow inflated; momentum is real.
  4. Delivery： 
    🦆 胖丁探店 · 腰部探店号（粉丝43万）
势能真实（非互关号），但 612 条作品才到43万，单条转化偏一般。
建议：适合做"量级匹配、预算可控"的腰部投放；想要爆发力强的可再对标几个同量级账号看作品/粉丝比。
（想横向对标，可接 douyin-similar-account / douyin-top-account 拉同赛道账号一起看）

Connection: this skill checks profiles; deeper analysis goes to sibling skills

The profile is just the starting point. When users want to go further, naturally mention available skills (no hard sell):

  • Wanthorizontal benchmarking against accounts in the same niche → douyin-similar-account / douyin-top-account(view a row of accounts at once and place this account in the coordinate system).
  • Want to seewhich specific work by this account went viral → douyin-account-works / douyin-search(work-level data, supplementing play/like counts not returned by this skill).
  • Onlynickname without secUid → first use douyin-search / tiktok-account-search to search out the account and get secUid, then return to this skill.

Boundaries and fault tolerance

  • secUid not obtained: Ask the user to provide it, or first search for the account to get secUid.Strictly forbidden to fabricate a secUid to try。
  • success !== true: Handle according to the error code reference table below.
  • PROVIDER_FAILED（502）: Upstream temporary failure,automatically refunded, safe to retry, no duplicate charge.
  • profile Some profile fields missing: Mark missing fields as "N/A", present the remaining fields as usual,do notestimate or fill in values.
  • Data looks incorrect: Just present the API return values truthfully; do not "correct" on behalf of the API.

Error code reference

HTTP code Meaning / Handling
401 MISSING_API_KEY / UNAUTHORIZED Key not set or invalid—check DOUBAOYA_API_KEY
400 VALIDATION_ERROR Invalid params—verify secUid is complete and correctly formatted
402 INSUFFICIENT_CREDITS Insufficient quota—top up at doubaoya.com and retry
502 PROVIDER_FAILED Upstream temporary failure,automatically refunded, safe to retry

Project structure

douyin-account-insight/
├── SKILL.md                    # 技能定义（本文件）
└── scripts/
    └── query_account.py        # 都爆鸭账号档案查询脚本（零依赖）

FAQ

Q1: How to get an API Key? Go to doubaoya.com log in → Token Center → Generate token, get dyh_…, set it in the environment variable DOUBAOYA_API_KEY. This duck will not echo your Key.

Q2: I only have a nickname or profile link. Can I look it up? This API only recognizes secUid. Please provide the secUid (in the form MS4wLjABAAAA...), or first use a Douyin account-search skill to search by nickname to find the secUid, then come back. This duck will not guess using a nickname.

Q3: Why is there no play count / engagement rate / multi-dimensional score? This API is a profile-level query and only returns nickname, follower count, following count, and post count. For post-level data, please connect to skills such as douyin-account-works . This duck only reports real fields and never fabricates.

Q4: What should I do when it shows INSUFFICIENT_CREDITS ? Insufficient quota. Go to doubaoya.com to top up and try again.

Q5: What should I do when it shows PROVIDER_FAILED ? The upstream temporarily failed. The system has automatically refunded. Just retry directly (retrying is safe).