抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 服务端API介绍
  • 小游戏 OpenAPI SDK 总览
  • 接口调用凭证
  • 登录
  • 开放数据
  • 二维码
  • 订阅消息
  • 消息推送客服
  • 游戏礼包
  • 游戏内容安全
  • 推荐流直出游戏能力
  • 社交互动能力
  • 动态分享
  • 消息推送
  • 抖音客服平台-客服能力
  • Schema链接
  • 公会群解绑
  • 游戏群标签能力
  • 上报赛事报名用户
  • 选手排名上报
  • 广告变现数据开放API
  • 流量主广告数据查询
  • 广告金账户余额查询
  • 广告金赠送金额查询
  • 广告金转充流水查询
  • 流量主广告数据查询

    收藏
    我的收藏

    接口说明

    查询小游戏广告变现数据,支持按日期范围及广告位、宿主应用、操作系统、归因渠道等维度筛选,用于经营分析和效果评估

    基本信息

    名称描述
    HTTP URL
    https://minigame.zijieapi.com/mgplatform/api/apps/ad/income/query
    HTTP Method
    POST
    Scope
    open.ttgame.mgplatform
    权限要求
    流量主广告收入接口

    请求参数

    请求头
    content-type必填String
    固定值"application/json"
    Body展开全部子属性
    Common必填Struct
    展开子属性
    end_date必填String
    结束日期 yyyy-MM-dd,必传
    Page必填Struct
    展开子属性
    start_date必填String
    开始日期 yyyy-MM-dd,必传
    ad_typeString
    广告位类型,如果不传递广告位类型名称,将默认返回全部类型广告位的数据: 广告位类型名称 枚举值: banner:Banner interstitial:插屏 video: 激励视频
    BaseStruct
    展开子属性
    channelString
    归因渠道来源,如果不传归因渠道来源,将默认返回全部归因渠道来源的数据 枚举值: AD:广告 Star:星图-口价 Pop:发行人 Nature:自然
    host_appString
    宿主 APP,如果不传递宿主 APP,将默认返回全部宿主的数据 枚举值: toutiao:今日头条 toutiao_lite:头条极速版 douyin:抖音 douyin_lite:抖音极速版 xigua:西瓜视频 fanqie:番茄小说 pipixia:皮皮虾 hongguo:红果 novel:番茄畅听 fanqie_music:番茄音乐 qishui:汽水音乐
    osString
    操作系统,如果不传操作系统,将默认返回全部操作系统的数据 枚举值: ios:ios android:安卓 open_harmony:鸿蒙
    请求示例
    curl --location 'http://minigame.zijieapi.com/mgplatform/api/apps/ad/income/query' \ --header 'access-token: xxx' \ --header 'Content-Type: application/json' \ --data '{ "Common":{ "access-token":"xxx", "mp_id":"xxx" }, "start_date": "2025-02-01", "end_date": "2025-03-02", "page_no": 1, "page_size": 20, "Page": { "page_no": 1, "page_size": 20 }, "Base": { "LogID": "202408212023569E4E311CD0F1CC3BF7B7", "Caller": "", "Addr": "", "Client": "", "TrafficEnv": { "Open": false, "Env": "" }, "Extra": { "": "", "env": "prod" } } }'

    响应参数

    Body展开全部子属性
    BaseResp必填Struct
    展开子属性
    itemsList
    展开子属性
    PageStruct
    展开子属性
    traceStruct
    展开子属性
    响应示例
    正常响应示例异常响应示例
    { "items": [ { "date": "2026-01-01", "host_app": "douyin", "os": "android", "channel": "organic", "ad_type": "reward_video", "request_pv": 100000, "show_pv": 80000, "click_pv": 5000, "click_rate": 0.0625, "ecpm": 35.6, "income_before_share": 2850.12, "income_after_share": 1995.08 } ], "page": { "total": 1 }, "trace": { "log_id": "abc-123", "cache_hit": true } }
    切换单列布局

    错误码

    HTTP 状态码错误码错误码描述排查建议
    20028001429
    qps超限
    20028001005
    系统内部错误,请重试
    请求重试,若依然无解请向平台提交反馈
    20028001003
    access_token无效
    重新请求生成access_token
    20028001008
    access_token过期,请刷新或重新授权
    重新请求生成access_token
    20028001016
    当前应用已被封禁或下线
    clientKey被封禁或者下线
    20028001006
    网络调用错误,请重试
    重试即可
    20028001014
    应用未授权任何能力
    确认应用是否授权能力
    20028001018
    应用未获得该能力
    开通相关能力
    20028003017
    quota已用完
    联系平台处理
    20028001019
    应用该能力已被封禁
    该能力被封禁,联系平台处理
    20028001007
    参数不合法
    根据错误信息检查请求参数是否填写正常
    20028001451
    查询范围超限