Lingxing
切换旧版

查询DSP广告主列表

POST/pb/openapi/newad/dspAdvertiserList

接口信息

API Path请求协议请求方式令牌桶容量
/pb/openapi/newad/dspAdvertiserListHTTPSPOST10

请求参数

offsetinteger
分页起始值，服务端将其作为分页组件的 current 参数使用，默认 0
lengthinteger
每页返回条数，默认 15

请求对象虽继承了 nextToken 字段，但当前接口未使用该字段；请使用 offset 和 length 分页。

请求示例

{
    "offset": 0,
    "length": 15
}

返回结果

JSON Object

codeinteger必填
业务状态码，0 表示成功
示例 0
messagestring必填
响应消息
示例 操作成功
error_detailsarray<any>必填
错误详情列表
示例 []
request_idstring必填
请求链路 ID
示例 52688b81-2398-4e60-9617-619fc2cf5b1e
response_timestring必填
响应时间，格式为 yyyy-MM-dd HH:mm:ss，时区 GMT+8
示例 2026-07-31 10:14:22
totalinteger必填
当前部门下 DSP 广告主总数
示例 3
dataarray<object>必填
DSP 广告主列表
示例 []
隐藏子属性
advertiserIdinteger必填
DSP 广告主 ID
示例 123456789012345
accountIdstring必填
账户 ID
示例 1234567890
currencystring必填
货币代码
示例 USD
countryCodestring必填
店铺国家代码
示例 US
namestring必填
广告主名称
示例 Example DSP Advertiser
timezonestring必填
时区
示例 America/Los_Angeles
regionstring必填
区域
示例 NA
statusinteger必填
广告主状态码；当前接口未定义状态码的枚举含义
示例 1
advertiserCountrystring必填
广告主国家代码
示例 US
nextTokenstring
当前接口未用于分页，固定为 null
示例 null

返回成功示例

{
    "code": 0,
    "message": "操作成功",
    "error_details": [],
    "request_id": "52688b81-2398-4e60-9617-619fc2cf5b1e",
    "response_time": "2026-07-31 10:14:22",
    "data": [
        {
            "advertiserId": 123456789012345,
            "accountId": "1234567890",
            "currency": "USD",
            "countryCode": "US",
            "name": "Example DSP Advertiser",
            "timezone": "America/Los_Angeles",
            "region": "NA",
            "status": 1,
            "advertiserCountry": "US"
        }
    ],
    "total": 3,
    "nextToken": null
}

响应状态码

code说明
0操作成功
102参数不合法，例如请求体不是有效 JSON，或字段类型不匹配
500服务内部异常