XIJIAN DOCS

集星 API 对接笔记

接口规格与四坑(digit_value/重试/session/比率标度) · ← 返回文档中心

目录
基本信息接口清单对接三坑(照抄既有实现,能少踩)犀见侧实现要点

集星达人 API 对接笔记(dls.lynoxi.com)

2026-08-17 用户提供的接口清单与实战坑(照录)。犀见获取集星达人数据的唯一方式——不读远程数据库,只走 API(用户定案)。

基本信息

接口清单

1. 达人基础档案 GET /api/jixing/influencer/{uid}

uid = 抖音数字 UID(如 100026950322,非抖音号)。

关键字段(对犀见的用途标注):

字段 含义 犀见用途
uid / unique_id / nick_name / gender / avatar_url / self_intro 基础档案 达人域档案
city_name / resident_city_name / resident_city_code 城市 / 常驻城市 估价距离项(行情锚的车马费分段)、硬门槛"异地无法拍摄"
fans_count / local_fans_count / fans_tag_list(如 "49% 为女性") 粉丝数 / 本地粉丝 / 画像标签 品宣硬门槛(≥20w)、用户商业匹配
level / item_level / live_level / content_level 等级四件套 SOP 硬门槛(品效 LV6+ / 团购 LV4+)、账号类型判定
credit_score / status / is_craft 信用分 / 状态 数据健康度
cooperation_detail.item_great_product_category_list 擅长类目(如 酒店宾馆/景点票券) 品类匹配(酒旅类判定)
sale_detail.item_pay_amt_avg_30d 近 30 天均单额 转化信号
quotations(type + min/max digit_value) 报价区间 估价行情锚的直接数据源
sales_rank_info.rank_label 榜单(如 "宣城视频榜第 42 名") 展示/参考
support_contact_info.support_contact_way 联系方式支持(aweme_im / phone_or_wechat) 建联可达性

2. 带货表现 GET /api/jixing/creator/{uid}

data.talent_item_statistice 下 18 个指标,统一结构 {label, statistice_value:{value, digit_value, notation, unit, prefix}, desc},默认统计周期 default_item_date_n: 30(近 30 天)。

key 含义 犀见用途
talent_item_gmv 带货总销售额(样本 44.21万 / digit 44214338) 转化信号
talent_video_avg_gmv 稿均销售额 SOP 评分卡"稿均销量"
talent_video_avg_vv 稿均播放量 SOP 评分卡"近 30 天稿均播放"
talent_video_gpm 稿均千次曝光 GMV 性价比信号
talent_video_avg_finish_rate 稿均完播率 内容质量信号
talent_video_avg_anchor_click_rate POI 锚点点击率 转化意向信号
talent_item_indirect_gmv 种草成交额 转化信号
talent_item_cnt 带货次数 接单密度参考
talent_video_avg_like/comment/share_cnt 互动均值 互动质量
item_merchant_case 合作商家案例 展示/参考
talent_item_category_filter_list 擅长类目 品类匹配

3. 登录维护 GET /api/jixing/login?phone=...(一般不用)

采集服务 session 掉了才需要,正常调用会自动处理。客户端不要主动调(见坑 3)。

对接三坑(照抄既有实现,能少踩)

  1. 数值取 digit_value,不要取 value:value 是展示串("44.21"+notation"万"、"<100"、"5万+"),digit_value 才是精确数。实测样本:稿均订单数 value 显示 <100 而 digit_value 是 78。
  2. 判成功看 status_code == 0,且业务上再判 fans_num > 0(既有实现的 valid 字段口径)。status_code 非 0 通常是被反爬拦了,应重试而不是当失败。重试策略照抄:非批量最多 3 次(2 秒起递增);批量场景阶梯退避 30s→60s→… 最长 512 分钟。
  3. data 为空但 status_code=0 = 采集服务的集星 session 过期,服务端会自行恢复,客户端等着重试即可,别自己去调登录接口。
  4. 比率字段(完播率/锚点点击率等)的 digit_value 本身已是 0-1 小数value 才是百分数展示串(生产实测 2026-08-16,uid 100026950322:digit 0.04497… ↔ value "4.5" + unit "%")——照 digit 原样存,再 /100 会错 100 倍(差点重演旧仓单位混用坑,首版实现就犯了,靠真实探测抓回)。

犀见侧实现要点