流量来源

开发环境

POST

https://developer.toutiao.com/api/apps/v1/data_analysis/query_video_with_source

获取小程序的短视频-流量来源分析数据。数据内容与“小程序控制台-运营-数据-短视频-流量来源”模块保持一致。

使用限制

每日 14:00 前更新前一日数据

只能查询昨天以前，且是近90天内的数据

权限要求：服务商代调用场景下，需商家授予数据分析权限集。

错误码

错误码	描述	排查建议
10002	参数不合法或缺少参数	检查参数合法性
10001	系统错误	建议重试

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://developer.toutiao.com/api/apps/v1/data_analysis/query_video_with_source' \
--header 'access-token;' \
--header 'content-type: application/json' \
--data-raw '{
  "start_time": 1679760000,
  "end_time": 1684857600,
  "host_name": "douyin", 
  "aweme_short_id_list": []
}'

响应示例

200 - 示例 1

{
  "data": {
    "DataList": [
      {
        "CommonData": {
          "MpDrainagePv": 0,
          "MpDrainageUv": 0,
          "MpShowPv": 0,
          "MpShowUv": 0
        },
        "Scenes": "string",
        "ScenesName": "string",
        "VideoPlayCount": 0
      }
    ]
  },
  "err_msg": "string",
  "err_no": 0
}

请求参数

Header 参数

content-type

string

必需

access-token

string

必需

Body 参数application/json

start_time

integer

必需

开始时间，必须是昨天以前的某个时间戳

end_time

integer

必需

结束时间，必须是昨天以前的某个时间戳

host_name

string

可选

宿主APP，douyin-抖音；douyin_lite-抖音lite；toutiao-今日头条；tt_lite-今日头条lite；huoshan-抖音火山版；

aweme_short_id_list

array[string]

选择的抖音号列表

可选

示例

返回响应

🟢200成功

application/json

Body

data

object

可选

DataList

array [object {4}]

可选

err_msg

string

必需

err_no

integer

必需

🟠400请求有误

修改于 2023-12-07 02:55:26

短视频详细数据

接口 1

流量来源

使用限制#

错误码#

请求参数

返回响应

使用限制

错误码