获取人群包列表
需要携带 Token,详情看 Token
用于获取人群包信息列表,单次最多获取 500 个人群包信息
请求地址
https://ss-api.mintegral.com/api/open/v1/audience
请求方法
GET
请求示例
json
GET /api/open/v1/audience?ta_ids=123,456,789&ta_name=xyz&platform=2&limit=10&page=1 HTTP/1.1
Host: ss-api.mintegral.com
请求参数
注:默认值为"—"表示当前字段无默认值
字段 | 类型 | 说明 | 默认值 | 例子 |
---|---|---|---|---|
ta_ids 选填 | string | 查询此人群包 ID 的数据,多个用,隔开 | -- | 123,456,789 |
ta_name 选填 | string | 查询此人群包名称的数据,支持模糊查询 | -- | xyz |
platform 选填 | int | 人群包投放平台 1:Android,2:iOS,3:mix | -- | 2 |
limit 选填 | int | 每页数量,最大值 500 | 10 | 10 |
page 选填 | int | 页数 | 1 | 1 |
响应结果
字段 | 类型 | 说明 |
---|---|---|
code | int | 200 表示成功,其他表示失败 |
msg | string | 成功,返回"success",失败返回相应的错误信息 |
data | json | 成功,返回广告单元信息,失败返回具体的错误信息 |
page | int | 当前在第几页 |
limit | int | 当前数量限制 |
current_total | int | 当前页数量 |
total | int | 总数量 |
list | array<json> | |
ta_id | int | 人群包 ID |
platform | int | 人群包平台 |
ta_name | int | 人群包名称 |
ta_type | int | 人群包类型 1:上传人群包 |
device_type | string | 设备类型 1:IMEI ,2:IDFA, 3:GAID, 4:OAID, 6:IMEI_MD5, 7:IDFA_MD5, 8:GAID_MD5, 9:OAID_MD5, 10:IDFV, 11:IDFV_MD5 |
area_type | int | 数据集群 1:非中国大陆地区, 2:中国大陆地区 |
ctime | int | 创建时间(时间戳) |
utime | int | 更新时间(时间戳) |
应答示例
json
{
"code": 200,
"message": "success",
"data": {
"page": 1,
"limit": 2,
"current_total": 2,
"total": 3,
"list": [
{
"ta_id": 1147,
"platform": 2,
"ta_name": "12314154wtwtw-2-1704871621",
"ta_type": 1,
"device_type": "2,8,9",
"area_type": 1,
"ctime": 1704871629,
"utime": 1704871631
},
{
"ta_id": 1146,
"platform": 2,
"ta_name": "12314154wtwtw-2-1704870794",
"ta_type": 1,
"device_type": "2",
"area_type": 1,
"ctime": 1704870806,
"utime": 1704870806
}
]
}
}