抖音用户搜索API教程：按关键词查找创作者

想通过API查找特定领域的抖音创作者？无论你是在构建KOL发现工具、监控竞品账号，还是自动化社交媒体研究，SandBase的抖音用户搜索API都能让你通过关键词程序化地搜索抖音创作者数据库。

本教程将教你如何调用API、解析响应数据，并将其集成到实际工作流中——附带可直接运行的curl和Python示例。

为什么需要通过API搜索抖音用户？

抖音拥有超过7亿日活用户和数百万内容创作者。通过App手动搜索创作者既费时又无法规模化。基于API的方案让你能够：

发现KOL（关键意见领袖）：通过搜索相关关键词，找到美妆、科技、美食、健身等任何垂类的达人。
监控竞品：追踪新出现的竞品账号或现有账号的资料变更。
构建社交聆听工具：自动化发现讨论你品牌或行业的创作者。
驱动营销自动化：将创作者数据接入你的CRM或商务合作工具。
进行市场调研：了解中国最大短视频平台上各品类的头部声音。

SandBase是什么？

SandBase是一个统一API网关，将数十个社交媒体和数据API聚合在一个一致的接口下。你不需要处理每个平台不同的认证方式、速率限制和响应格式——只需调用一个端点、使用一个API密钥。

针对抖音，SandBase提供用户搜索、视频搜索、创作者主页等API——全部通过同一个 https://api.sandbase.ai/v1/run 端点访问。

准备工作

开始之前，你需要：

SandBase账号 — 在 sandbase.ai 注册
API密钥 — 在SandBase控制台生成
额度 — SandBase采用按次计费的额度系统，抖音用户搜索API每次请求消耗少量额度

就是这么简单。不需要抖音开发者账号，不需要实现OAuth流程，不需要中国企业营业执照。

API概览

抖音用户搜索API的关键信息：

参数	值
端点	`https://api.sandbase.ai/v1/run`
方法	POST
模型	`douyin/creator/user-search`
认证	Bearer token（你的SandBase API密钥）
输入	搜索关键词
输出	匹配的用户资料列表

响应包含丰富的创作者数据：

用户名和昵称
粉丝数
视频总数
个人简介
头像URL
认证状态
唯一用户ID（可用于后续API调用）

第一步：发起第一个API调用（curl）

让我们搜索与”咖啡”相关的抖音创作者：

curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SANDBASE_API_KEY" \
  -d '{
    "model": "douyin/creator/user-search",
    "input": {
      "keyword": "咖啡",
      "count": 10
    }
  }'

这会搜索资料或内容与”咖啡”相关的创作者，返回最多10个结果。

理解响应数据

API返回如下JSON响应：

{
  "status": "success",
  "data": {
    "users": [
      {
        "uid": "MS4wLjABAAAA...",
        "nickname": "咖啡师小王",
        "signature": "专注精品咖啡 | 每日分享拉花技巧",
        "avatar_url": "https://p3.douyinpic.com/aweme/...",
        "follower_count": 528000,
        "video_count": 342,
        "is_verified": true,
        "custom_verify": "咖啡领域创作者"
      },
      {
        "uid": "MS4wLjABAAAA...",
        "nickname": "每日咖啡日记",
        "signature": "探店 | 家庭咖啡 | 器具评测",
        "avatar_url": "https://p3.douyinpic.com/aweme/...",
        "follower_count": 215000,
        "video_count": 189,
        "is_verified": false,
        "custom_verify": ""
      }
    ],
    "total": 2,
    "has_more": true
  }
}

每个用户对象都提供了评估创作者是否与你的需求相关所需的全部信息。

第二步：Python集成

以下是适用于生产环境的Python实现：

import requests
import json

class DouyinUserSearch:
    """通过SandBase API搜索抖音创作者。"""

    def __init__(self, api_key: str):
        self.api_key = api_key
        self.endpoint = "https://api.sandbase.ai/v1/run"

    def search(self, keyword: str, count: int = 10) -> dict:
        """
        按关键词搜索抖音用户。

        参数:
            keyword: 搜索关键词（中文或英文）
            count: 返回结果数量（默认10）

        返回:
            包含匹配用户资料的字典
        """
        headers = {
            "Content-Type": "application/json",
            "Authorization": f"Bearer {self.api_key}"
        }

        payload = {
            "model": "douyin/creator/user-search",
            "input": {
                "keyword": keyword,
                "count": count
            }
        }

        response = requests.post(
            self.endpoint,
            headers=headers,
            json=payload
        )
        response.raise_for_status()
        return response.json()


# 使用示例
api_key = "your_sandbase_api_key_here"
client = DouyinUserSearch(api_key)

# 搜索咖啡相关创作者
results = client.search("咖啡", count=10)

# 处理结果
for user in results["data"]["users"]:
    print(f"昵称: {user['nickname']}")
    print(f"粉丝数: {user['follower_count']:,}")
    print(f"视频数: {user['video_count']}")
    print(f"简介: {user['signature']}")
    print("---")

添加错误处理

生产系统中建议加入重试逻辑和错误处理：

import time
from typing import Optional

def search_with_retry(
    client: DouyinUserSearch,
    keyword: str,
    count: int = 10,
    max_retries: int = 3
) -> Optional[dict]:
    """带指数退避的搜索重试。"""
    for attempt in range(max_retries):
        try:
            return client.search(keyword, count)
        except requests.exceptions.HTTPError as e:
            if e.response.status_code == 429:
                wait_time = 2 ** attempt
                print(f"触发速率限制，{wait_time}秒后重试...")
                time.sleep(wait_time)
            else:
                raise
        except requests.exceptions.RequestException as e:
            print(f"请求失败: {e}")
            if attempt < max_retries - 1:
                time.sleep(2 ** attempt)
    return None

第三步：实际应用场景

场景一：营销活动的KOL发现

查找护肤垂类的头部创作者并按粉丝数筛选：

results = client.search("护肤", count=20)

# 筛选腰部达人（10万-50万粉丝）
mid_tier_kols = [
    user for user in results["data"]["users"]
    if 100_000 <= user["follower_count"] <= 500_000
]

print(f"找到 {len(mid_tier_kols)} 位腰部护肤达人")
for kol in mid_tier_kols:
    print(f"  {kol['nickname']} — {kol['follower_count']:,} 粉丝")

场景二：竞品监控

追踪与你品牌或竞品相关的账号：

competitors = ["品牌A", "品牌B", "品牌C"]

for brand in competitors:
    results = client.search(brand, count=5)
    users = results["data"]["users"]
    print(f"\n{brand}: 找到 {len(users)} 个相关账号")
    for user in users:
        print(f"  @{user['nickname']} ({user['follower_count']:,} 粉丝)")

场景三：构建社交监控Agent

将抖音用户搜索与AI Agent框架结合，构建自动化社交情报系统：

# AI Agent工作流伪代码
keywords = ["你的品牌名", "行业关键词", "竞品名称"]

for keyword in keywords:
    creators = client.search(keyword, count=10)

    # 将结果存入数据库
    for creator in creators["data"]["users"]:
        save_to_db(creator)

    # 发现新的高粉账号时告警
    new_accounts = filter_new_accounts(creators["data"]["users"])
    if new_accounts:
        send_alert(f"关键词'{keyword}'发现新账号: {new_accounts}")

SandBase Instagram User ID API页面

与其他SandBase API组合使用

真正的威力在于组合多个API实现全面的社交情报。SandBase提供覆盖中国主流社交平台的API：

平台	API模型	用途
抖音用户搜索	`douyin/creator/user-search`	查找创作者
抖音视频搜索	`douyin/video/search`	查找热门内容
小红书	`xiaohongshu/note/search`	跨平台研究
微博	`weibo/user/search`	追踪讨论

通过组合这些API，你可以构建覆盖中国主流平台的全方位社交监控系统，而且只需一个API网关。

更多关于抖音数据API的详情，请查看我们的指南：SandBase上的抖音数据API。如果你正在构建消费社交数据的AI Agent，请阅读2026年社交媒体数据API与AI Agent。

SandBase API控制台

定价与速率限制

SandBase采用基于额度的定价模型：

按次计费 — 只为实际使用付费
无月度最低消费 — 适合测试和小型项目
批量折扣 — 高频用户可获得优惠
透明定价 — 在控制台查看额度使用情况

抖音用户搜索API通常每次请求消耗少量额度。请查看 SandBase定价页面了解最新费率。

最佳实践

使用中文关键词 — 抖音是中文平台，使用中文搜索比英文能获得更好的结果。
关键词要具体 — “精品咖啡”比”咖啡”返回更精准的结果。
组合多次搜索 — 使用相关关键词多次搜索，构建更全面的创作者列表。
缓存结果 — 用户资料不会频繁变化，缓存结果可以节省额度。
遵守速率限制 — 实现退避逻辑以优雅处理429响应。

总结

通过SandBase的抖音用户搜索API，你可以用简单统一的方式搜索中国最大短视频平台上的创作者。只需一次API调用，你就能：

为营销活动找到相关KOL
监控竞品账号和新入局者
构建自动化社交聆听工具
为AI Agent提供实时社交数据

SandBase统一接口、按次计费和丰富响应数据的组合，使其适用于从快速研究脚本到生产级社交情报平台的各种场景。

立即注册SandBase，开始你的第一次API调用。