菜单

获取创意信息

需要携带 Token，详情看Token

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

请求地址

https://ss-api.mintegral.com/api/open/v1/creative-ad/list

请求方法

GET

请求示例

json 复制代码

GET /api/open/v1/creative-ad/list
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{ "ad_ids": [2131252991, 2131252990] }

请求参数

字段	类型	是否必填	说明	默认值	例子
ad_ids	array<int64>	Y	创意ID	—	`2131252991`
demand_package_name	string	N	推广包名	—	`com.xxx.xx`
page	int	N	分页, 从1开始, 默认为1	`1`	`1`
limit	int	N	分页每页记录数，默认20，最大100	`20`	`20`

我们推荐您使用ad_ids而不是demand_package_name，因为使用demand_package_name时我们会返回全部的创意，而不是仅返回您收到的那部分

响应结果

字段	类型	说明
code	int	200 表示成功，其他表示失败
message	string	成功，返回"success"，失败返回相应的错误信息
data	json	成功，返回素材组信息，失败返回具体的错误信息
limit	int	数据页记录数上限
page	int	数据页
total	int	总记录数
list	array<object>	记录详情
ad_id	int	创意ID
ad_name	string	创意名称
offer_id	int64	广告单元id
offer_uuid	string	广告单元唯一名称
creative_set_id	int64	创意组ID
creative_set_name	string	创意组名称
combination_method	int	创意组创意组装方式, 1为程序化，2为自定义
ad_output	int	【枚举值-创意类型及要求尺寸】
creatives	array<object>	创意素材详情
creative_id	int64	素材ID
creative_name	string	素材名称
creative_md5	string	素材md5
creative_type	string	素材类型, IMAGE、VIDEO、PLAYABLE
creative_url	string	素材链接

应答示例

json 复制代码

{
  "code": 200,
  "message": "success",
  "data": {
    "limit": 1,
    "page": 1,
    "total": 13,
    "list": [
      {
        "creative_set_id": 1317,
        "creative_set_name": "auto_default_ALL",
        "ad_id": 2131252991,
        "ad_name": "lixiantest_ss_custom_20240726_111_6699150e1321a_lixiantest_ss_url_20240725",
        "combination_method": 2,
        "ad_output": 212,
        "offer_id": 190511,
        "offer_uuid": "ss_uuid123",
        "creatives": [
          {
            "creative_id": 2705156619,
            "creative_name": "lixiantest_ss_url_20240725",
            "creative_md5": "9c3ee4b0b39a5ee0606aca40ad7f9262",
            "creative_type": "PLAYABLE",
            "creative_url": "https://playable.dspunion.com/playable_test/dsp_zh-cn_98_VFNZYl667_an/dsp_zh-cn_98_VFNZYl667_an.html"
          },
          {
            "creative_id": 2705156616,
            "creative_name": "6699150e1321a.mp4",
            "creative_md5": "05e23f9241f9abb0742f646f8c16da35",
            "creative_type": "VIDEO",
            "creative_url": "http://cdn-adn.rayjump.com/cdn-adn/v2/portal/24/07/19/11/20/6699db7883bd7.mp4"
          }
        ]
      }
    ]
  }
}

上一个

更新广告单元创意组

下一个

素材

最近修改: 2025-07-14

大纲