Skip to content

获取人群包列表

需要携带 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每页数量,最大值 5001010
page 选填int页数11

响应结果

字段类型说明
codeint200 表示成功,其他表示失败
msgstring成功,返回"success",失败返回相应的错误信息
datajson成功,返回广告单元信息,失败返回具体的错误信息
pageint当前在第几页
limitint当前数量限制
current_totalint当前页数量
totalint总数量
listarray<json>
ta_idint人群包 ID
platformint人群包平台
ta_nameint人群包名称
ta_typeint人群包类型
1:上传人群包
device_typestring设备类型
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_typeint数据集群
1:非中国大陆地区, 2:中国大陆地区
ctimeint创建时间(时间戳)
utimeint更新时间(时间戳)

应答示例

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
            }
        ]
    }
}