- id
- 该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
- url
- 该记录在原平台上的可访问链接。
- text
- 正文内容,已去除 HTML 标签。长文可能被截断。
- media_type
- 媒体类型。
- like_count
- 点赞数。null 表示该平台或该接口不公开此数据,不等于 0。
- comment_count
- 评论数。null 表示不公开,不等于 0。
- share_count
- 分享/转发数。null 表示不公开,不等于 0。
- collect_count
- 收藏数。null 表示不公开,不等于 0。
- view_count
- 播放量。抖音不对外公开播放量,该字段恒为 0,不代表真实播放;判断视频热度请用 like_count(点赞)、comment_count、share_count。
- author_name
- 作者昵称(显示名)。
- author_id
- 作者在原平台的唯一 ID。
- author_douyin_id
- 作者抖音号。
- author_follower_count
- 作者粉丝数。null 表示不公开。
- region
- 地区。
- posted_at
- 发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
- platform
- 数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
- user_id
- 用户在原平台的唯一 ID。
- douyin_id
- 抖音号(用户自定义的可搜索 ID)。
- nickname
- 昵称。
- bio
- 个人简介,账号自己填写的文本。可能含换行和 emoji。
- follower_count
- 粉丝数。null 表示不公开,不等于 0。
- following_count
- 关注数。null 表示不公开,不等于 0。
- video_count
- 视频数。
- gender
- 性别。
- ip_location
- IP 属地(平台强制展示,非用户填写)。
- is_verified
- 是否为平台认证账号(蓝V等)。null 表示无法判定。
- avatar_url
- 头像图片链接。部分平台给的是带尺寸参数的 CDN 链接,可能有时效。
- reply_count
- 回复数,通常用于评论的子回复。null 表示不公开。
- liked_by_author
- 评论是否被作者点赞。作者亲自点赞的评论互动价值高。
- is_reply
- 是否为回复。
- reply_to_id
- 被回复评论 ID。
- rank
- 热榜排名。
- keyword
- 热点关键词。
- hot_value
- 热榜热度值。抖音自有指标,只在榜单内可比。
- board
- 所属榜单。
- image_url
- 图片链接。多图能力可能返回 image_urls 数组。
- event_time
- 热点事件时间。
- title
- 标题。平台无标题概念时(如纯文本帖)为 null。
- play_count
- 播放量。抖音不对外公开播放量,该字段恒为 0;热度判断请用点赞/评论/分享数。
- author_avatar
- 作者头像。
- is_live
- 账号在采集时是否正在直播;属于时点状态。
- source_keyword
- 本行命中的搜索关键词。
- audience_distribution
- 粉丝受众分布桶;value 是 0–1 的份额小数,不是百分数、人数或实际买家占比。
- audience_tgi
- 受众桶相对平台平均的 TGI 指数;与份额 value 是独立量纲,不是人数或成交占比。
- dimension_code
- 画像维度:device_price_band、gender、age 或 province;由请求 option 映射,不把领先分布桶标签当维度。
- follower_trend
- 粉丝数量随日期变化的序列。
- average_follower_count
- 趋势窗口内的平均粉丝量。
- average_post_count
- 对标窗口内的平均发布量。
- average_comment_count
- 对标窗口内的平均评论量。
- average_share_count
- 对标窗口内的平均分享量。
- average_follower_growth
- 对标窗口内的平均新增粉丝量。
- average_like_count
- 对标窗口内的平均点赞量。
- post_count_percentile
- 发布量在同类账号中的百分位。
- comment_count_percentile
- 评论量在同类账号中的百分位。
- share_count_percentile
- 分享量在同类账号中的百分位。
- follower_growth_percentile
- 新增粉丝量在同类账号中的百分位。
- like_count_percentile
- 点赞量在同类账号中的百分位。
- creator_id
- 星图商业达人稳定 ID;不是公开主页 user_id 或抖音号。
- city
- 城市名,用原平台的语言书写,未做中英归一。
- creator_score
- 星图达人综合指数;只在同一次取得的结果中比较。
- engagement_rate_30d
- 星图近 30 天互动率。
- expected_play_count
- 星图预期播放量;属于平台估计,不是实际播放结果。
- expected_natural_play_count
- 星图预期自然播放量;属于平台估计。
- interaction_median_30d
- 星图近 30 天互动量中位数。
- play_over_rate_30d
- 星图近 30 天完播率。
- follower_growth_30d
- 星图近 30 天涨粉量。
- follower_growth_rate_15d
- 星图近 15 天涨粉率。
- content_themes
- 平台给达人标记的内容主题标签。
- ecommerce_level
- 星图电商能力等级。
- ecommerce_score
- 星图电商能力分;是平台指标,不是实际成交额。
- gmv_30d_range
- 星图近 30 天 GMV 区间;是区间/估计,不是精确成交额。
- gpm_30d_range
- 星图近 30 天 GPM 区间字符串;不改写为精确值。
- average_order_value_30d_range
- 星图近 30 天客单价区间字符串;不是真实订单明细。
- commercial_index
- 星图商业价值指数。
- conversion_index
- 星图转化能力指数。
- spread_index
- 星图传播能力指数。
- shopping_index
- 星图种草能力指数。
- quote_1_20s_cny
- 1–20 秒视频报价,人民币元。
- quote_20_60s_cny
- 20–60 秒视频报价,人民币元。
- quote_60s_plus_cny
- 60 秒以上视频报价,人民币元。
- creator_type
- 星图返回的达人类型。
- average_play_count
- 星图返回的平均播放量。
- category_id
- 星图达人分类 ID。
- tags
- 标签数组。无标签时为空数组,不是 null。
- creator_grade
- 星图达人等级。
- is_xingtu_creator
- 是否为星图达人。
- ecommerce_enabled
- 是否具备星图电商能力标记。
- lowest_quote_cny
- 星图展示的最低合作报价,人民币;是报价,不是成交价。
- rate_tiers
- 星图报价档位;每档保留形式说明、实际报价、原报价、结算说明、视频类型与开放状态。
- cpm_cny
- 星图榜单展示的千次曝光成本,人民币元。
- completed_order_range
- 已完成品牌合作订单的平台区间字符串;不是精确订单数。
- repurchase_rate_range
- 客户复购率的平台区间字符串;不是精确比率。
- item_order_rate
- 星图展示的内容下单率。
- average_view_count
- 榜单快照内的平均视频播放量。
- previous_rank
- 同榜单上一期排名。
- ranking_score
- 星图榜单综合分;只在同一榜单与时间窗内比较。
- is_new
- 是否为本期新进榜达人。
- ranking_board
- 星图榜单展示名称。
- period_days
- 榜单统计周期天数。
- snapshot_date
- 榜单快照日期,格式 YYYYMMDD。
- source_kind
- 数据来源类型;当前公开契约只接受并返回 ranking。
- product_id
- 抖音商城商品稳定 ID。
- promotion_id
- 抖音带货计划中的推广 ID。
- white_image_url
- 商品白底图 URL。
- price_cny
- 商品展示价格,人民币元。
- price_cny_minor
- 商品展示价格,人民币分的整数值。
- price_label
- 商品价格标签,例如到手价。
- monthly_sales
- 商品近 30 天销量。
- good_review_ratio
- 商品好评率百分比。
- sales_trend
- 商品近 30 天每日销量序列。
- category_path
- 商品从一级到叶子类目的名称路径。
- category_depth
- 商品类目路径深度。
- shop_id
- 抖音商城店铺 ID。
- shop_name
- 抖音商城店铺名称。
- shop_logo_url
- 店铺 Logo URL,可能带有效期。
- shop_score
- 店铺公开体验分(如有)。
- commission_rate_percent
- 公开带货佣金比例。
- commission_cny
- 按当前展示价计算的佣金金额,人民币。
- cooperating_creator_count
- 商品带货计划显示的合作达人数;不能反推某位指定达人卖过该商品。
- search_rank
- 商品在该关键词自然搜索结果中的位置。
- discount_price_cny
- 商品当前公开优惠价,人民币元;缺失时不从原价推算。
- sales_text
- 商品详情公开销量原文。
- sold_count
- 商品详情当前公开的已售数量;是采集时快照,不等于指定达人销量。
- shop_avatar_url
- 抖音商城店铺头像 URL。
- main_image_urls
- 商品头图/轮播图 URL 列表。
- detail_image_urls
- 商品详情长图 URL 列表。
- assurances
- 商品公开服务保障标签。
- shipping_fee_text
- 商品公开运费或发货地说明原文。
- shipping_estimate_text
- 商品公开预计发货说明原文。
- variant_groups
- 商品规格组与可选项;只保留规格名、选项名和公开规格 ID。
- on_sale
- 商品在采集时是否显示在售。
- sku_id
- 抖音商城 SKU ID;与商品 product_id 不是同一标识。
- live_room_id
- 采集时挂载该商品的直播间 ID;只表示当前直播搜索命中。
- is_live_product
- 是否由当前直播商品搜索明确返回;不是历史直播归因。