# 抖音 达人搜索 API (douyin.creator_search)

- Canonical page: https://everyinfra.com/douyin-api/creator_search
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "douyin", "action": "creator_search", "params": {...}}
- Price: $0.000556 per call ($0.56 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 20 per call
- Mode: sync; add "mode": "async" for slow tasks

抖音达人搜索按 `keyword` 发现账号，返回昵称、抖音号、主页链接、头像、粉丝数、性别、认证状态和是否正在直播。它回答「这个领域有哪些可以合作的达人」，是达人投放、竞品账号梳理和 KOL 名单搭建的起点；后续能力传结果里的 `user_id`（secUid），`uid` 是同一账号的数字 ID。

用 `follower_range` 按粉丝区间筛选，用 `user_type` 只看普通、企业或认证个人账号。结果是候选名单，不是精确的身份匹配：同名、相似名的账号都可能出现，确认合作对象前请核对主页。`is_live` 是读取那一刻的直播状态。

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=douyin&action=creator_search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | 达人昵称、抖音号或相关关键词；返回账号发现结果，不是视频搜索。 |
| follower_range | enum: 100k_to_1m / 10k_to_100k / 1k_to_10k / over_1m / under_1k | no | not declared | 账号发现的粉丝区间：under_1k、1k_to_10k、10k_to_100k、100k_to_1m、over_1m；不传表示不限。 |
| user_type | enum: business / general / verified_individual | no | not declared | 账号类型：general、business、verified_individual；不传表示不限。 |
| limit | integer (1–20) | no | 20 | 这次调用最多返回的条数，整数，1–20；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| user_id | 用户在原平台的唯一 ID。 |
| douyin_id | 抖音号（用户自定义的可搜索 ID）。 |
| nickname | 昵称。 |
| url | 该记录在原平台上的可访问链接。 |
| avatar_url | 头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。 |
| follower_count | 粉丝数。null 表示不公开，不等于 0。 |
| gender | 性别。 |
| is_verified | 是否为平台认证账号（蓝V等）。null 表示无法判定。 |
| verify_reason | 认证说明原文（profile / creator_search），企业认证或个人认证的文字；未认证的账号为空或没有这个字段。 |
| is_live | 账号在采集时是否正在直播；属于时点状态。 |
| uid | 数字用户 ID（profile / creator_search）；user_id 是 secUid，两者是同一账号的两种 ID。 |
| source_keyword | 本行命中的搜索关键词。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "douyin",
  "action": "creator_search",
  "params": {
    "keyword": "美食"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "douyin",
        "action": "creator_search",
        "params": {
            "keyword": "美食",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-10-24T18:28:34Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "douyin",
  "action": "creator_search",
  "results": [
    {
      "user_id": "•••",
      "douyin_id": "•••",
      "nickname": "•••",
      "url": "https://www.douyin.com/•••",
      "avatar_url": "•••",
      "follower_count": 1299670,
      "gender": 0,
      "is_verified": false,
      "verify_reason": "",
      "is_live": 0,
      "uid": "•••",
      "source_keyword": "美食",
      "platform": "douyin"
    }
  ],
  "count": 1,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### 搜到的账号一定就是我要找的人吗？

不一定。达人搜索返回的是与关键词相关的候选账号，同名或相似昵称的账号都可能出现。确认前请打开 `url` 核对主页，对照 `douyin_id`（抖音号），已认证账号还可以看 `verify_reason` 的认证说明。

### 怎么只找粉丝量合适的达人？

`follower_range` 取 `under_1k`、`1k_to_10k`、`10k_to_100k`、`100k_to_1m` 或 `over_1m`，只返回对应粉丝区间的账号，不传表示不限；再配合 `user_type` 排除企业号或只看认证个人。

### 找到达人之后还能查什么？

把结果里的 `user_id` 传给抖音的用户内容、达人粉丝画像、达人涨粉趋势等能力，分别看作品、受众构成和粉丝变化，再判断是否适合合作。

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=douyin
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md