# 抖音 达人粉丝画像 API (douyin.creator_audience)

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

达人粉丝画像每次返回一个维度：用 `dimension` 选设备价格带 `device_price_band`（默认）、性别 `gender`、年龄 `age` 或省份 `province`，`dimension_code` 标明结果对应的维度。想看多个维度，就分别传不同的 `dimension` 调用。

`audience_distribution` 里每个分桶的份额是 0 到 1 的小数，不是百分数，也不是人数；`audience_tgi` 是这个分桶相对平台平均的 TGI 指数，和份额是两个独立的量，一个说占多大，一个说和平台平均比偏离多少。两者都是粉丝分布，不能当成视频观众、商品买家或成交用户的画像。

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| user_id | not declared | yes | not declared | 抖音用户的 secUid（通常以 MS4w 开头），不是昵称或短数字抖音号。用于定位 profile / user_posts 的账号；可从搜索结果的 author_id 或抖音用户主页链接取得。 |
| dimension | enum: age / device_price_band / gender / province | no | not declared | 达人粉丝画像维度：device_price_band 设备价格带（默认）、gender 性别、age 年龄、province 省份。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| user_id | 用户在原平台的唯一 ID。 |
| audience_distribution | 粉丝受众分布桶；value 是 0–1 的份额小数，不是百分数、人数或实际买家占比。 |
| audience_tgi | 受众桶相对平台平均的 TGI 指数；与份额 value 是独立量纲，不是人数或成交占比。 |
| dimension_code | 画像维度：device_price_band、gender、age 或 province；由请求 option 映射，不把领先分布桶标签当维度。 |
| 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_audience",
  "params": {
    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS"
  }
}'
```

```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_audience",
        "params": {
            "user_id": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS",
        },
    },
    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_audience",
  "results": {
    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS",
    "audience_distribution": [
      {
        "label": "2000~2999",
        "value": 0.21259893463305227
      },
      {
        "label": "5000~5999",
        "value": 0.16836679678233302
      },
      {
        "label": "1000~1999",
        "value": 0.14285406198106493
      }
    ],
    "audience_tgi": [
      {
        "label": "3000~3999",
        "value": 121.50162156159308
      },
      {
        "label": "7000~7999",
        "value": 107.46785052961428
      },
      {
        "label": "0~999",
        "value": 34.04478663045582
      }
    ],
    "dimension_code": "device_price_band",
    "platform": "douyin"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### 分布里的份额是百分数吗？

不是。`audience_distribution` 里每个分桶的份额是 0 到 1 的小数，不是百分数、人数，也不是实际买家占比。要显示成百分比，自己换算。

### `audience_tgi` 和份额对不上时信哪个？

两个量纲独立，并不冲突。份额回答这个分桶占整个粉丝群多大，`audience_tgi` 回答它和平台平均比是高是低；它同样不是人数，也不是成交占比。分桶之间排序时先想清楚要比的是哪一个。

### 粉丝画像能说明买家是谁吗？

不能。这里是粉丝分布，不能写成视频观众、商品买家或成交用户画像，也不能据此枚举出具体的粉丝。要看达人带货的品类和转化区间，用星图达人转化能力那一页。

## 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