들어 오세요
메뉴

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

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

creative_md5, creative_name, creative_type, resolution 기준의 조회를 지원하며, 크리에이티브 목록을 조회하는 방법은 다음과 같습니다.

요청 주소

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

요청 메서드

GET

요청 예시

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 }

요청 파라미터

Fields Type Explanations Default Value Examples
creative_md5 Optional string 크리에이티브의 고유 MD5입니다. 여러 MD5는 ,로 구분하세요. 참고: 한 번의 검색에서 최대 200개까지 조회할 수 있습니다. — "0a6335cd9151ac5dc79ad996f4e12674"
creative_name Optional string 크리에이티브 이름 — "creative_test.png"
creative_type Optional string 크리에이티브 유형입니다. 포함 값: "IMAGE", "VIDEO", "PLAYABLE" — "IMAGE"
resolution Optional string 크리에이티브 해상도입니다. 여러 항목은 .로 구분하세요.
참고: 한 번의 검색에서 최대 200개까지 조회할 수 있습니다.		 — "1200x627"
page Optional int 페이지 1 1
limit Optional int 페이지당 제한 수입니다. 최대값: 200
200을 초과하면 200을 반환합니다.		 200 50

응답

Fields Type Explanations
code int 200이면 성공입니다. 그 외 코드는 실패를 의미합니다.
msg string 성공 시 "success"를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
data json 성공 시 크리에이티브 데이터를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
page int 현재 페이지
limit int 수량 제한
total int 총 개수
list array<json>
creative_type string 크리에이티브 유형입니다. 포함 값: "IMAGE", "VIDEO", "PLAYABLE"
creative_md5 string 크리에이티브의 고유 MD5
creative_name string 크리에이티브 이름
resolution string 크리에이티브의 픽셀 또는 규격
size number 크리에이티브 크기입니다. 단위는 KB입니다.
language string 플레이어블 광고 언어
platform string 플레이어블 광고 적용 플랫폼입니다. ENUM 값: "ANDROID", "IOS", "ALL"

응답 예시

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
      }
    ]
  }
}
이전의
API: 크리에이티브 업로드하기(기술 가이드)
다음
Reporting API
최근 수정됨: 2026-08-06