菜单

获取广告单元创意组

需要携带 Token，详情看Token

获取创意组信息, 支持按条件分页查询

请求地址

https://ss-api.mintegral.com/api/open/v1/creative_sets

请求方法

GET

请求示例

json 复制代码

GET /api/open/v1/creative_sets
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{ "offer_id": 3028 }

请求参数

字段	类型	是否必填	说明	默认值	例子
offer_id	int	N	广告单元ID	—	`123`
creative_set_id	int	N	创意组ID	—	`123`
creative_set_name	string	N	创意组名称	—	`set_name1`
combination_method	int	N	创意制作方式	-	`set_name1`
page	int	N	分页, 从1开始	`1`	`1`
limit	int	N	分页每页记录数，默认10，最大50	`10`	`20`

响应结果

字段	类型	说明
code	int	200 表示成功，其他表示失败
msg	string	成功，返回"success"，失败返回相应的错误信息
data	json	成功，返回素材组信息，失败返回具体的错误信息
limit	int	数据页记录数上限
page	int	数据页
total	int	总记录数
list	array<object>	记录详情
offer_id	int	广告单元ID
creative_set_id	int	创意组ID
creative_set_name	string	创意组名称
combination_method	int	创意组创意组装方式
ad_outputs	array<int>	枚举值-创意类型及要求尺寸
geos	array<string>	投放地区
creatives	array<object>	创意组包含素材详情
creative_name	string	素材名称
creative_md5	string	素材md5
creative_type	string	素材类型
dimension	string	素材尺寸
created_at	int	素材绑定到创意组的时间
audit_status	int	素材审核状态, 0为初始化，1为通过，2为拒审，3为审核中
audit_reason	string	素材拒审原因

应答示例

json 复制代码

{
  "msg": "success",
  "code": 200,
  "data": {
    "limit": 10,
    "page": 1,
    "total": 1,
    "list": [
      {
        "offer_id": 100,
        "creative_set_id": 1317,
        "creative_set_name": "test_group_1",
        "combination_method": 1,
        "ad_outputs": [
          111,
          121,
          131
        ],
        "geos": [
          "ALL"
        ],
        "creatives": [
          {
            "creative_name": "image_1.jpg",
            "creative_md5": "4066f7e9738eb0cfe87f59e752f8d64f",
            "creative_type": "IMAGE",
            "dimension": "1200x627",
            "created_at": 1714124002,
            "audit_status": 1,
            "audit_reason": ""
          },
          {
            "creative_name": "image_2.jpg",
            "creative_md5": "9d4af767418b5e20a936c7c07f017e39",
            "creative_type": "IMAGE",
            "dimension": "1200x627",
            "created_at": 1714124002,
            "audit_status": 1,
            "audit_reason": ""
          },
          {
            "creative_name": "video_1.jpg",
            "creative_md5": "9d4af767418b5e20a936c7c07f017e39",
            "creative_type": "VIDEO",
            "dimension": "1280x720",
            "created_at": 1714124002,
            "audit_status": 1,
            "audit_reason": ""
          }
        ]
      }
    ]
  }
}

上一个

创意组

下一个

创建广告单元创意组

最近修改: 2025-07-14

大纲