메뉴

API: 크리에이티브 정보 조회하기(기술 가이드)

오퍼를 관리하려면 Mintegral 토큰을 사용해야 합니다. 자세한 내용은 Token을 확인하세요.

Mintegral API를 사용해 크리에이티브 정보를 조회하고 조건부 페이지네이션 쿼리를 지원하는 방법은 다음과 같습니다.

요청 주소

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

요청 메서드

GET

요청 예시

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] }

요청 파라미터

field	dataType	isRequired	desc	defaultValue	example
ad_ids	array<int64>	Y	ad_id	—	`2131252991`
demand_package_name	string	N	프로모션 패키지명	—	`com.xxx.xx`
page	int	N	페이지. 1부터 시작합니다.	`1`	`1`
limit	int	N	제한 수. 최대 100	`20`	`20`

demand_package_name은 패키지와 연결된 모든 크리에이티브를 반환하므로, 접근 권한이 있는 특정 크리에이티브만 조회하려면 demand_package_name 대신 ad_ids를 사용하는 것을 권장합니다.

응답

Field	Data Type	Description
code	int	200이면 성공입니다. 그 외 값은 실패를 의미합니다.
message	string	성공 시 "success"를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
data	json	응답 페이로드입니다. 성공 시 중첩 데이터를 반환합니다.
limit	int	페이지네이션 제한 수입니다.
page	int	현재 페이지 번호입니다.
total	int	전체 레코드 수입니다.
list	array<object>	상세 항목 목록입니다.
ad_id	int	광고의 고유 식별자입니다.
ad_name	string	광고 이름입니다.
offer_id	int64	오퍼의 고유 식별자입니다.
offer_uuid	string	오퍼의 UUID입니다.
creative_set_id	int64	크리에이티브 세트의 고유 식별자입니다.
creative_set_name	string	크리에이티브 세트 이름입니다.
combination_method	int	크리에이티브 조합 방식: `1`(Programmatic), `2`(Custom).
ad_output	int	크리에이티브 세트의 예상 출력 유형입니다. 다음을 참고하세요. [ENUM Ad Output]
creatives	array<object>	크리에이티브 상세 목록입니다.
creative_id	int64	크리에이티브의 고유 식별자입니다.
creative_name	string	크리에이티브 이름입니다.
creative_md5	string	크리에이티브 파일의 MD5 해시입니다.
creative_type	string	크리에이티브 유형: `IMAGE`, `VIDEO`, `PLAYABLE`.
creative_url	string	크리에이티브 에셋에 접근할 수 있는 URL입니다.

응답 예시

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

개요