API: Retrieving Creative Set Data (Technical Guide)

Label：API ,API key ,Creative Set Data ,technical guide ,developer guide

You need to use your Mintegral token to manage your offers. For more details, please check Token.

Get creative set information and support for conditional page numbering queries

Request method

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

Request method

GET

Request example

json Copy

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

Request Params

field	dataType	isRequired	desc	defaultValue	example
offer_id	int	N	offer ID	—	`123`
creative_set_id	int	N	creative set id	—	`123`
creative_set_name	string	N	creative set name	—	`set_name1`
combination_method	int	N	the combination method of creative_set:1: programmatic creative set 2: customized creative set	-	`set_name1`
page	int	N	page, starting with 1	`1`	`1`
limit	int	N	limit, max:50	`10`	`20`

Response

field	dataType	desc
code	int	200 code, is success. Others, are fail
msg	string	If success, return to "success". If fail, return to detailed wrong info
data	json	If success, return to "success". If fail, return to detailed wrong info
limit	int	limit
page	int	page
total	int	total row
list	array<object>	/
offer_id	int	offerID
creative_set_id	int	Unique identifier for the creative set.
creative_set_name	string	Name for the creative set.
combination_method	int	the combination method of creative_set:1: programmatic creative set 2: customized creative set
ad_outputs	array<int>	The types of ideas the creative set expects to assemble are listed below [ENUM Ad Output]
geos	array<string>	Countries/regions where creative sets are used
creatives	array<object>	List of creatives bound to the creative set
creative_name	string	creative_name
creative_md5	string	creative_md5
creative_type	string	creative_type
dimension	string	dimension
created_at	int	The time when the creative is bound to the creative group
audit_status	int	Creative review status: 0 for initialized, 1 for approved, 2 for rejected, 3 for under review
audit_reason	string	Reason for material rejection

Response Example

json Copy

{
  "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": ""
          }
        ]
      }
    ]
  }
}

API: Creative Set (Technical Guide

API: Creating Creative Sets (Technical Guide)

Last modified: 2025-08-28

Outline