FeedMCP

数据接口 / 抖音

星图达人观众画像 API

看过这个达人作品的观众分布:性别、年龄、地域、城市等级、设备、兴趣和八大人群。

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

参数

参数 类型 必填 说明
id string 是 星图达人 ID(用 douyin.xingtu.creators.lookup 从抖音账号换,或者从达人搜索里拿)

所有接口还支持 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.004。对象不存在、没取到数据、参数错误、平台出错、超时都不收费。

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

调用示例

cURL

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

Python

import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/douyin/xingtu/creators/audience/get",
    params={"id": "7439277672863105076"},
    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/xingtu/creators/audience/get?id=7439277672863105076", {
  headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());

MCP

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

{
  "endpoint": "douyin.xingtu.creators.audience.get",
  "params": {
    "id": "7439277672863105076"
  },
  "max_price": "0.004"
}

返回示例

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

{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "items": [
      {
        "platform": "douyin",
        "dimension": "gender",
        "title": "性别分布",
        "summary": "男性居多,占比83%",
        "items": [
          {
            "label": "男",
            "value": 365522,
            "share": 0.8387
          },
          {
            "label": "女",
            "value": 70274,
            "share": 0.1613
          }
        ]
      },
      {
        "platform": "douyin",
        "dimension": "age",
        "title": "年龄分布",
        "summary": "31到40岁居多",
        "items": [
          {
            "label": "31-40",
            "value": 179218,
            "share": 0.6682
          },
          {
            "label": "24-30",
            "value": 88975,
            "share": 0.3318
          }
        ]
      }
    ]
  },
  "page": {
    "next_cursor": null,
    "has_more": false
  },
  "warnings": [],
  "meta": {
    "endpoint": "douyin.xingtu.creators.audience.get",
    "platform": "douyin",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "source": "FeedMCP",
    "catalog_revision": "d09a736bd39e8b3f",
    "billing": {
      "charged": true,
      "amount": "0.004",
      "currency": "USD",
      "balance": "9.98"
    }
  }
}

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

抖音的其他接口

常见问题

星图达人观众画像接口多少钱?

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

需要平台账号吗?

不需要,只取公开数据。

ID 或链接怎么找?

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

怎么取更多条?

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

怎么在 AI 里用?

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