Acquiring Creative List
PS: You need to use Token to change the status, for more details, please check Token
Acquire creative list, support inquiry according to creative_md5、creative_name、creative_type、resolution.
Request Address
https://ss-api.mintegral.com/api/open/v1/creatives/source
Request Method
GET
Request Example
json
GET /api/open/v1/creatives/source
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{ "page": 1, "creative_type": "VIDEO", "limit": 10 }
Request Parameter
Fields | Type | Explanations | Default Value | Examples |
---|---|---|---|---|
creative_md5 Optional | string | Unique md5 for creative, Please use , to separate multiple md5. Note: the maximum number for one search is 200. | — | "0a6335cd9151ac5dc79ad996f4e12674" |
creative_name Optional | string | Creative name | — | "creative_test.png" |
creative_type Optional | string | Creative Type, including:"IMAGE" 、"VIDEO" 、"PLAYABLE" | — | "IMAGE" |
resolution Optional | string | Resolution of creative. Please use . to separate multiple md5. Note: the maximum number for one search is 200. | — | "1200x627" |
page Optional | int | Page | 1 | 1 |
limit Optional | int | Limit for each page. Maximum: 200 >200, return to 200 | 200 | 50 |
Response
Fields | Type | Explanations |
---|---|---|
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 creatives data. If fail, return to detailed wrong info. |
page | int | current page |
limit | int | quantity limit |
total | int | total amount |
list | array<json> | |
creative_type | string | Creative Type. Including:"IMAGE" 、"VIDEO" 、"PLAYABLE" |
creative_md5 | string | Unique md5 for creative |
creative_name | string | Creative name |
resolution | string | Pixel or dimension of creative |
size | number | Size of creative, the unit is KB. |
language | string | Language of playable ads |
platform | string | Applicable platform of playable ads.Enum value: "ANDROID" 、"IOS" 、"ALL" |
Response Example
json
{
"code": 200,
"msg": "success",
"data": {
"page": 1,
"limit": 2,
"total": 4,
"list": [
{
"creative_type": "IMAGE",
"creative_name": "dd.png",
"creative_md5": "0a6335cd9151ac5dc79ad996f4e12674",
"resolution": "300x300",
"size": 10.039,
"language": null,
"platform": null
},
{
"creative_type": "IMAGE",
"creative_name": "aaa.png",
"creative_md5": "0a6335cd9151ac5dc79ad996f4e12674",
"resolution": "300x300",
"size": 10.039,
"language": null,
"platform": null
}
]
}
}