跳转至

广告账户流水信息

获取广告账户流水信息。

请求地址

https://openapi.aiclk.com/openapi/v1/account_fund/list

所属权限

ads_read

请求方式

GET

请求参数

字段名 类型 是否必须 描述
account_id int 广告主ID(广告投放平台的userID)
query string 请求参数结构,json格式,具体字段如下

query参数

字段名 类型 是否必须 描述
start_date string 开始时间,例如:2021-05-01
end_date string 结束时间,例如:2021-05-31
page int 页码,默认为1
page_size int 每页记录数,默认为10
fields []string 需要的返回字段,允许值:"cash_cost","coupon_cost","compensation","date"

请求示例

 curl -X GET \
  'https://openapi.aiclk.com/openapi/v1/account_fund/list?account_id=1000002&query={"page": 1,"page_size":5,"start_date": "2020-01-01","end_date": "2021-06-18","fields":["date","cash_cost","coupon_cost","compensation"]}' \
  -H 'Host: openapi.aiclk.com' \
  -H 'OGW_ACCESS_TOKEN: your_access_token'

返回字段释义

字段名 类型 描述
code int 返回码
message string 返回信息
data json 返回值,json格式,包含字段如下
- list object 返回值列表
-- cash_cost int 现金消耗,单位为分
-- coupon_cost int 优惠券消耗,单位为分
-- compensation int 赔付金额,单位为分
-- date string 日期
- page_info object 分页信息
-- page int 页码
-- page_size int 每页记录数
-- total_number int 总记录数

返回示例

{
  "code": 200,
  "message": "success",
  "data": {
    "list": [
      {
        "cash_cost": 10000032,
        "coupon_cost": 1000022,
        "compensation": 1000000,
        "date": "2021-05-01"
      },
      {
        "cash_cost": 10000232,
        "coupon_cost": 1000122,
        "compensation": 1002000,
        "date": "2021-05-02"
      }
    ],
    "page_info": {
      "page": 1,
      "page_size": 10,
      "total_number": 12
    }
  }
}