FeedMCP

数据接口 / 抖音

巨量算数达人粉丝画像 API

一个达人粉丝的性别、年龄、省份、城市、城市等级、设备品牌、设备价格和兴趣,每项带占比和 TGI。

项目 值
地址 GET https://api.feedmcp.com/v1/douyin/index/creators/audience/get
ID douyin.index.creators.audience.get
价格 $0.002 / 次
返回 一页 分布对象列表
认证 Authorization: Bearer $FEEDMCP_API_KEY

参数

参数 类型 必填 说明
id string 是 抖音数字 uid(抖音账号资料或星图达人资料里的 uid),不是 sec_user_id

所有接口还支持 view=full:在返回里附上平台的原始数据(raw),价格不变。

返回字段

data.items 是一组「分布」对象,所有平台字段相同:

字段 类型 说明
platform string 平台
dimension string 维度:gender、age、province、city、city_tier、device、interest、crowd(八大人群)、content
title string | null 平台上的名称,例如年龄分布
summary string | null 平台给的一句话结论,例如「31到40岁居多,占比42%」
items {label, value, share, tgi}[] 每一项的人数(或条数)、占比(0–1)和 TGI(偏好度,100 是平均,大于 100 表示更偏好;只有巨量算数给),从多到少

什么时候扣费

成功取到数据一次 $0.002。对象不存在、没取到数据、参数错误、平台出错、超时都不收费。

每次返回的 meta.billing 里写着这次扣了多少、还剩多少余额。

调用示例

cURL

curl "https://api.feedmcp.com/v1/douyin/index/creators/audience/get?id=4317100619601754" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"

Python

import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/douyin/index/creators/audience/get",
    params={"id": "4317100619601754"},
    headers={"Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}"},
    timeout=30,
)
print(r.json())

JavaScript

const res = await fetch("https://api.feedmcp.com/v1/douyin/index/creators/audience/get?id=4317100619601754", {
  headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());

MCP

在装好 FeedMCP 的 AI 里,调用 call 工具:

{
  "endpoint": "douyin.index.creators.audience.get",
  "params": {
    "id": "4317100619601754"
  },
  "max_price": "0.002"
}

返回示例

示例数据是虚构的,格式和真实返回一致。

{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "items": [
      {
        "platform": "douyin",
        "dimension": "gender",
        "title": "性别",
        "summary": null,
        "items": [
          {
            "label": "男",
            "value": null,
            "share": 0.839,
            "tgi": 159.7
          },
          {
            "label": "女",
            "value": null,
            "share": 0.161,
            "tgi": 34.9
          }
        ]
      },
      {
        "platform": "douyin",
        "dimension": "age",
        "title": "年龄",
        "summary": null,
        "items": [
          {
            "label": "31-40",
            "value": null,
            "share": 0.42,
            "tgi": null
          }
        ]
      }
    ]
  },
  "page": {
    "next_cursor": null,
    "has_more": false
  },
  "warnings": [],
  "meta": {
    "endpoint": "douyin.index.creators.audience.get",
    "platform": "douyin",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "source": "FeedMCP",
    "catalog_revision": "d09a736bd39e8b3f",
    "billing": {
      "charged": true,
      "amount": "0.002",
      "currency": "USD",
      "balance": "9.98"
    }
  }
}

出错时的格式见 错误码:每个错误都写明扣没扣钱(charged)和能不能重试(retry)。

抖音的其他接口

常见问题

巨量算数达人粉丝画像接口多少钱?

成功取到数据一次 $0.002。对象不存在、没取到数据、参数错误、平台出错、超时都不收费。

需要平台账号吗?

不需要,只取公开数据。

ID 或链接怎么找?

作品 ID 是视频链接 /video/ 后面的数字;账号用主页链接 /user/ 后面的 sec_user_id,不是抖音号。

怎么取更多条?

返回里有 page.next_cursor 时,把它作为 cursor 参数传回来取下一页。每一页单独计费。

怎么在 AI 里用?

装好 MCP 后直接说你要什么,AI 会调用 douyin.index.creators.audience.get。