メニュー

API: クリエイティブ情報取得（テクニカルガイド）

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

MintegralのAPIを使用してcreative infoを取得し、条件付きpage numbering queriesをサポートする方法は以下のとおりです。

Request Address

https://ss-api.mintegral.com/api/open/v1/creative-ad/list

Request method

GET

Request example

json Copy

GET /api/open/v1/creative-ad/list
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{ "ad_ids": [2131252991, 2131252990] }

Request Params

field	dataType	isRequired	desc	defaultValue	example
ad_ids	array<int64>	Y	ad_id	—	`2131252991`
demand_package_name	string	N	Promotion package name	—	`com.xxx.xx`
page	int	N	page。1から開始します	`1`	`1`
limit	int	N	limit。max:100	`20`	`20`

demand_package_nameではなくad_idsを使用することをおすすめします。demand_package_nameを使用すると、アクセス権のある特定のcreativeのみではなく、そのpackageに関連付けられたすべてのcreativesが返されるためです。

Response

Field	Data Type	Description
code	int	200はsuccessを示します。その他の値はfailureを示します。
message	string	成功した場合は"success"を返します。失敗した場合は詳細なerror infoを返します。
data	json	Response payload。成功した場合はnested dataを返します。
limit	int	Pagination limit。
page	int	Current page number。
total	int	Total number of records。
list	array<object>	詳細itemsのlist。
ad_id	int	adのUnique identifier。
ad_name	string	adのName。
offer_id	int64	offerのUnique identifier。
offer_uuid	string	offerのUUID。
creative_set_id	int64	creative setのUnique identifier。
creative_set_name	string	creative setのName。
combination_method	int	Creative assembly method: `1` (Programmatic), `2` (Custom)。
ad_output	int	creative setのExpected output type。参照 [ENUM Ad Output]
creatives	array<object>	creative detailsのlist。
creative_id	int64	creativeのUnique identifier。
creative_name	string	creativeのName。
creative_md5	string	creative fileのMD5 hash。
creative_type	string	creativeのType: `IMAGE`, `VIDEO`, `PLAYABLE`。
creative_url	string	creative assetにアクセスするURL。

Response Example

json Copy

{
  "code": 200,
  "message": "success",
  "data": {
    "limit": 1,
    "page": 1,
    "total": 13,
    "list": [
      {
        "creative_set_id": 1317,
        "creative_set_name": "auto_default_ALL",
        "ad_id": 2131252991,
        "ad_name": "lixiantest_ss_custom_20240726_111_6699150e1321a_lixiantest_ss_url_20240725",
        "combination_method": 2,
        "ad_output": 212,
        "offer_id": 190511,
        "offer_uuid": "ss_uuid123",
        "creatives": [
          {
            "creative_id": 2705156619,
            "creative_name": "lixiantest_ss_url_20240725",
            "creative_md5": "9c3ee4b0b39a5ee0606aca40ad7f9262",
            "creative_type": "PLAYABLE",
            "creative_url": "https://playable.dspunion.com/playable_test/dsp_zh-cn_98_VFNZYl667_an/dsp_zh-cn_98_VFNZYl667_an.html"
          },
          {
            "creative_id": 2705156616,
            "creative_name": "6699150e1321a.mp4",
            "creative_md5": "05e23f9241f9abb0742f646f8c16da35",
            "creative_type": "VIDEO",
            "creative_url": "http://cdn-adn.rayjump.com/cdn-adn/v2/portal/24/07/19/11/20/6699db7883bd7.mp4"
          }
        ]
      }
    ]
  }
}

API: Creative Set更新（テクニカルガイド）

次

API: クリエイティブ管理（テクニカルガイド）

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

概要