菜单

获取人群包列表

需要携带 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
            }
        ]
    }
}

上一个

人群包

下一个

上传人群包文件

最近修改: 2025-07-14

大纲