douyin-kol-search

douyin-kol-search Douyin's most commercially valuable key opinion leaders KOLs (benchmark accounts)

Quick Start

More Skills

Overview

Douyin's most commercially valuable key opinion leaders (KOLs) are used to answer "how to find benchmark accounts," find collaboration influencers, find sales influencers, and find Douyin benchmark accounts. They are suitable for content creators, operations staff, marketers, and brands to use after clarifying business goals, content materials, or analysis targets. It combines inputs such as search keywords and input keywords to search KOLs (e.g., beauty, food, fashion...) to organize key context, and outputs leads for relevant creators / KOLs, benchmark account candidates, collaboration, and competitor research, making it easy to continue execution, review, or delivery.

When to Use

Applicable Scenarios

• The user wants to find Douyin influencers worth collaborating with
• The user wants to find accounts that are better at selling products or have higher commercial value
• The user wants to find Douyin benchmark accounts
• The user wants to find creators in the same niche, competitors, or similar creators

How to Call

Call the AI Skills API directly through the exported Python runner:

Command Examples

Filter by niche and follower range

python3 scripts/run.py --params '{"keyword":"深圳烧烤酒吧","contentTag":"tag-48","followerRange":"10-100"}'

Search influencers only by keyword

python3 scripts/run.py --params '{"keyword":"深圳烧烤酒吧"}'

Search influencers only by category

python3 scripts/run.py --params '{"contentTag":"tag-48"}'

Parameter Description

Parameter	Type	Required	Default	Description
page	number	No	1	Page number, starting from 1
keyword	string	Yes	-	Enter keywords to search KOLs (e.g., beauty, food, fashion...)
contentTag	string	No	-	Select a content category tag to filter; available values: Unrestricted (``), Beauty (tag-1), Fashion (tag-6), Pets (tag-11), Reviews (tag-15), Gaming (tag-23), ACG (tag-25), Travel (tag-27), Automotive (tag-31), Lifestyle (tag-36), Music (tag-41), Food (tag-48), Maternal and Child Parenting (tag-55), Sports and Fitness (tag-60), Tech and Digital (tag-64), Education and Training (tag-68), Appearance Influencers (tag-72), Talent and Skills (tag-79), Film and Entertainment (tag-85), Arts and Culture (tag-87), Finance and Investment (tag-91), Drama and Comedy (tag-97), Real Estate (tag-139), Home and Living (tag-1001）

See the complete machine-readable parameter structure at references/form-schema.json。

Parameter Value Reference

This skill currently has no category parameters that require an additional lookup table.

Supported Input Formats

This skill directly accepts JSON parameters and does not involve share link parsing.

Example Requests

The example parameters below can be passed directly to scripts/run.py, and the runner will send them to the AI Skills API.

python3 scripts/run.py --params '{"keyword":"深圳烧烤酒吧","contentTag":"tag-48","followerRange":"10-100"}'

Equivalent --params JSON：

{
  "keyword": "深圳烧烤酒吧",
  "contentTag": "tag-48",
  "followerRange": "10-100"
}

Example Result

{
  "success": true,
  "data": {
    "keyword": "深圳烧烤酒吧",
    "platformSource": "_1",
    "pagination": {
      "page": 1,
      "pageSize": 20,
      "total": 1
    },
    "items": [
      {
        "uid": "kol-1",
        "nickname": "深圳烧烤王",
        "region": "广东 深圳",
        "followerCount": 560000,
        "interactionRate30d": 0.082,
        "convertIndex": 82,
        "spreadIndex": 76,
        "starIndex": 91,
        "expectedPlayCount": 320000,
        "price20_60": 180000,
        "contentTags": [
          "美食"
        ]
      }
    ],
    "searchStrategy": {
      "usedFallback": true,
      "droppedFilters": [
        "contentTag"
      ],
      "localContentTagFilterApplied": true
    }
  },
  "meta": {
    "executionTime": 842,
    "cached": false
  }
}

Deliverables

• Creator candidate list: includes collaboration screening information such as account positioning, follower scale, and content tags.
• Commercial value leads: mainly assists in judging reach, conversion potential, and overall collaboration priority.
• Benchmark account references: used to find creators in the same niche, competitor accounts, and content samples worth learning from.

Suggestions for Using the Results

• First narrow down candidates by niche and keywords, then prioritize them by commercial value, reach, and conversion potential.
• When looking for collaboration creators, focus on whether the account positioning matches the brand; when looking for benchmark accounts, focus on content tags and audience similarity.
• If the screening criteria are too narrow and result in too few results, you can relax the follower count or keywords and then compare again.

Preparation Before Running

• AISKILLS_BASE_URL: default https://ai-skills.ai
• AISKILLS_API_KEY: required, used for authenticated calls
• AISKILLS_TENANT_ID: default default