メニュー

API: Creative Setデータ取得（テクニカルガイド）

offers を管理するには、Mintegral token を使用する必要があります。詳細は Token を確認してください。

creative set informationを取得し、条件付き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	creative_setのcombination method: 1: programmatic creative set 2: customized creative set	-	`set_name1`
page	int	N	page。1から開始します	`1`	`1`
limit	int	N	limit。max:50	`10`	`20`

Response

field	dataType	desc
code	int	200 codeはsuccessです。その他はfailです
msg	string	successの場合は"success"を返します。failの場合は詳細なerror infoを返します
data	json	successの場合は"success"を返します。failの場合は詳細なerror infoを返します
limit	int	limit
page	int	page
total	int	total row
list	array<object>	/
offer_id	int	offerID
creative_set_id	int	creative setのUnique identifier。
creative_set_name	string	creative setのName。
combination_method	int	creative_setのcombination method: 1: programmatic creative set 2: customized creative set
ad_outputs	array<int>	creative setがassembleする想定のcreative typeは以下に記載されています [ENUM Ad Output]
geos	array<string>	creative setsを使用するCountries/regions
creatives	array<object>	creative setにbindするcreativesのlist
creative_name	string	creative_name
creative_md5	string	creative_md5
creative_type	string	creative_type
dimension	string	dimension
created_at	int	creativeがcreative groupにbindされたtime
audit_status	int	Creative review status: 0はinitialized、1はapproved、2はrejected、3はunder review
audit_reason	string	material rejectionのreason

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（テクニカルガイド)

次

API: Creative Set作成（テクニカルガイド）

最近変更された: 2026-08-06

概要