Search...
Menu

API: Retrieving Creative Lists (Technical Guide)

Label：API ,API key ,developer guide ,technical guide ,creative list

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

Here's how to retrieve creative lists, support inquiries according to creative_md5,creative_name, creative_type, and resolution.

Request Address

https://ss-api.mintegral.com/api/open/v1/creatives/source

Request Method

GET

Request Example

json Copy 
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 Copy 
{
  "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
      }
    ]
  }
}
Previous
API: Uploading Creatives (Technical Guide)
Next
Reporting API
Last modified: 2025-08-28