接口说明

获取小程序的短视频交易分析数据。数据内容与“小程序控制台-数据-数据中心-短视频-核心数据”页面保持一致。

使用限制

每日 14:00 前更新前一日数据
只能查询昨天以前，且是近90天内的数据

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/platform/v2/data_analysis/query_video_deal_data/
HTTP Method	GET
权限要求	服务商代调用场景下，需商家授予数据分析权限集

请求参数

请求头

access-token必填String

当非服务商时，调用https://open.douyin.com/oauth/client_token/生成的token
当服务商时，调用https://open.douyin.com/api/tpapp/v2/auth/get_auth_token/生成的token

Query

end_time必填Int64

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

start_time必填Int64

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

host_nameString

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

请求示例
curl --location --request GET 'https://open.douyin.com/api/platform/v2/data_analysis/query_video_deal_data/?host_name=3CG0UQDQwS&start_time=2731693318676908061&end_time=6897302679551210592' \
--header 'content-type: application/json' \
--header 'access-token: 0801121846735352506a356a6' \

响应参数

Body展开全部子属性

err_msg必填String

错误信息

err_no必填Int32

错误码

log_id必填String

排查错误的logId

dataStruct

展开子属性

响应示例
正常响应示例异常响应示例
{
  "data": {
    "video_deal_data_list": [
      {
        "mp_show_uv": 166,
        "refund_order_cnt": 6,
        "clue_cnt": 0,
        "create_order_amount": 350,
        "create_order_cnt": 0,
        "customer_once_price": 21,
        "mp_drainage_pv": 771,
        "video_play_user_cnt": 0,
        "create_customer_cnt": 16,
        "mp_drainage_uv": 56,
        "mp_show_pv": 0,
        "time": "2023-11-25",
        "video_play_cnt": 0,
        "clue_ucnt": 0,
        "order_once_price": 18,
        "pay_customer_cnt": 16,
        "pay_order_amount": 350,
        "refund_customer_cnt": 3,
        "valid_clue_cnt": 0,
        "item_uv": 256,
        "item_vv": 702,
        "pay_order_cnt": 0,
        "refund_amount": 60,
        "valid_clue_ucnt": 0
      },
      {
        "refund_amount": 60,
        "valid_clue_ucnt": 0,
        "mp_drainage_pv": 771,
        "mp_show_uv": 166,
        "order_once_price": 18,
        "pay_customer_cnt": 16,
        "pay_order_cnt": 0,
        "video_play_cnt": 43,
        "video_play_user_cnt": 0,
        "customer_once_price": 21,
        "create_order_amount": 350,
        "mp_drainage_uv": 56,
        "refund_order_cnt": 6,
        "mp_show_pv": 9,
        "pay_order_amount": 350,
        "clue_cnt": 0,
        "clue_ucnt": 0,
        "create_customer_cnt": 16,
        "create_order_cnt": 0,
        "item_uv": 256,
        "item_vv": 702,
        "refund_customer_cnt": 3,
        "time": "2023-12-19",
        "valid_clue_cnt": 0
      }
    ],
    "video_deal_overview_data": {
      "clue_ucnt": 0,
      "create_order_cnt": 19,
      "mp_show_pv": 539,
      "mp_show_uv": 166,
      "video_play_cnt": 702,
      "video_play_user_cnt": 0,
      "clue_cnt": 0,
      "item_uv": 256,
      "mp_drainage_uv": 56,
      "order_once_price": 18,
      "pay_order_amount": 350,
      "refund_order_cnt": 6,
      "valid_clue_cnt": 0,
      "customer_once_price": 21,
      "mp_drainage_pv": 771,
      "pay_order_cnt": 19,
      "refund_amount": 60,
      "create_order_amount": 350,
      "item_vv": 702,
      "pay_customer_cnt": 16,
      "refund_customer_cnt": 3,
      "valid_clue_ucnt": 0,
      "create_customer_cnt": 16
    }
  },
  "err_msg": "",
  "err_no": 0,
  "log_id": "20240108212802ECEDCB8331F7EA16E3D1"
}

切换单列布局

错误码

HTTP 状态码	错误码	错误码描述	排查建议
200	-1	系统错误	建议重试，若多次重试失败，可向平台反馈该问题
200	11009	参数不合法或缺少参数	检查参数合法性，注意参数类型以及是否缺少必要参数
200	28001003	access_token无效	请检查access_token
200	28001007	必填字段缺失	请检查必填字段
200	28001008	access_token过期	请刷新或重新授权access_token

短视频交易分析在线调试

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

短视频交易分析