OkayAPI API: App.Douyin.GetFansDetailByDay

OkayAPI Docs

API Path: /api/App/Douyin/GetFansDetailByDay

API Description: 根据天数返回（每天0点05分统计，归属在前一天），已经授权的抖音账号的统计数据。使用前请先到抖音开放平台注册、认证并创建网站应用

API Traffic

HTTP/HTTPS

Protocol

GET/POST

Method

UTF-8

Charset

JSON

Response

API Debug

API Params

Parameter	Type	Required	Default	Note	Description
HTTP_APPKEY	String	Required		MIN: 32	Common Put Your APPKEY
open_id	String	Required			抖音的open_id
start_day	String	Required			开始天数（包含），例如20191122
end_day	String	Required			结束天数（包含），例如20191123
page	String	Required	1		页数
page_size	String	Required	20		每页展示数量

API Debug

Submit Type:

Form Data

JSON RAW(application/json;charset=UTF-8)

JSON RAW

KEY	REQUIRED	VALUE
app_key	*Required
open_id	*Required
start_day	*Required
end_day	*Required
page	*Required
page_size	*Required

API Response

KEY	Type	Description
err_code	Int	操作码，0表示成功，正数表示业务失败场景，负数表示系统失败场景
err_msg	String	错误提示信息，err_code非0时参考此提示信息
data	Object	获取到的粉丝数据
data.total	Array	数据总条数
data.list	Array	粉丝分布详情列表
data.list[].open_id	String	账号openid
data.list[].run_day	Int	统计的天数（例如20191122）
data.list[].all_fans_num	Int	粉丝总数
data.list[].man	Int	粉丝中男生数量
data.list[].woman	Int	粉丝中女生的数量
data.list[].age_0_25	Int	粉丝中<=25岁的粉丝数量
data.list[].age_26_32	Int	粉丝中26~32岁的粉丝数量
data.list[].age_33_39	Int	粉丝中33~39岁的粉丝数量
data.list[].age_40_46	Int	粉丝中40~46岁的粉丝数量
data.list[].age_47_100	Int	粉丝中>=47岁的粉丝数量
data.list[].active_days_0_1	Int	活跃天数<=1天的粉丝数量
data.list[].active_days_2_5	Int	活跃天数2~5天的粉丝数量
data.list[].active_days_6_10	Int	活跃天数6~10天的粉丝数量
data.list[].active_days_11_31	Int	活跃天数11~31天的粉丝数量
data.list[].flow_vv	Int	粉丝中来源为vv的粉丝数量
data.list[].flow_like_cnt	Int	粉丝中来源为like_cnt的粉丝数量
data.list[].flow_comment_cnt	Int	粉丝中来源为comment_cnt的粉丝数量
data.list[].flow_share_video_cnt	Int	粉丝中来源为share_video_cnt的粉丝数量
data.list[].geographical_distributions	String	粉丝地域分布
data.list[].device_distributions	String	粉丝设备分布
data.list[].interest_distributions	String	粉丝兴趣分布

HTTP Response Code

HTTP Status Code	Description
Http Status = 200	Success
Http Status = 400	Illegal-Params
Http Status = 401	Illegal-Token
Http Status = 402	IP-Banned
Http Status = 404	API-NOT-Exsits
Http Status = 406	Illegal-APPKEY
Http Status = 407	APPKEY-Expired-Out
Http Status = 408	APPKEY-Busy
Http Status = 409	Illegal-Sign
Http Status = 413	API-Traffic-NOT-Enough
Http Status = 415	API-LOCKED
Http Status = 500	Internal-Server-Error