Get Creative Sets

PS: You need to use Token to change the status, for more details, please check Token

Get creative set information and support conditional paginated query

Request method

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

Request method

GET

Request example

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_name	string	creative set name
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

{
  "msg": "success",
  "code": 200,
  "data": {
    "limit": 10,
    "page": 1,
    "total": 1,
    "list": [
      {
        "offer_id": 100,
        "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": ""
          }
        ]
      }
    ]
  }
}