메뉴

API: 캠페인 목록 조회하기(기술 가이드)

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

캠페인 목록을 조회합니다. campaign_id, campaign_name, package_name 기준의 조회를 지원합니다.

요청 주소

https://ss-api.mintegral.com/api/open/v1/campaign

요청 메서드

GET

요청 예시

json Copy

GET /api/open/v1/campaign
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{ "page": 1, "campaign_id": "1230,1231,1532", "limit": 10 }

요청 파라미터

Fields	Type	Explanations	Default Value	Examples
campaign_id `Optional`	int	캠페인의 고유 ID입니다. 여러 캠페인은 쉼표로 구분합니다. 참고: 한 번의 검색에서 최대 50개까지 조회할 수 있습니다.	—	`"1230,1231,1532"`
campaign_name `Optional`	string	캠페인에 대한 짧은 설명	—	`"campaign_test"`
package_name `Optional`	string	앱의 패키지명	—	`"test"`
offer_id `Optional`	int	오퍼의 고유 ID	—	`1234"`
offer_name `Optional`	string	오퍼의 고유 이름	—	`"offer_test"`
offer_uuid `Optional`	string	자동 생성된 고유 오퍼명	—	`"ss_offer_test"`
page `Optional`	int	페이지	1	`1`
limit `Optional`	int	페이지당 제한 수입니다. 최대값: 50 50을 초과하면 50을 반환합니다.	10	`15`

응답

Fields	Type	Explanations
code	int	200이면 성공입니다. 그 외 코드는 실패를 의미합니다.
msg	string	성공 시 "success"를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
data	json	성공 시 캠페인 데이터를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
page	int	현재 페이지
limit	int	수량 제한
total	int	총 개수
list	array<json>
campaign_id	int	캠페인의 고유 ID
campaign_name	string	추가한 캠페인명
is_coppa	string	COPPA 설정 값
promotion_type	string	설정한 프로모션 유형
alive_in_store	string	설정한 “alive in store” 값
preview_url	string	캠페인에 추가한 미리보기 링크
product_name	string	광고 목표 이름
package_name	string	홍보하려는 애플리케이션의 iOS App Store ID 또는 번들 ID
description	string	광고 목표 설명
icon	string	아이콘 또는 로고의 MD5
platform	string	캠페인 플랫폼
category	string	캠페인 카테고리
app_size	string	애플리케이션 크기
min_version	string	캠페인에서 설정한 최소 시스템 버전
maintain_by	string	오퍼 수정 권한입니다. maintain_by="AM"이면 캠페인 또는 오퍼의 세부 정보만 확인할 수 있습니다. maintain_by="ADV"이면 캠페인 또는 오퍼 설정을 자유롭게 변경할 수 있습니다.
status	string	캠페인 상태입니다. 열거 값은 [ENUM - Campaign Status]를 참고하세요.

응답 예시

json Copy

{
  "msg": "success",
  "code": 200,
  "data": {
    "page": 1,
    "limit": 10,
    "total": 2,
    "list": [
      {
        "campaign_id": 1234,
        "is_coppa": "YES",
        "campaign_name": "Test",
        "promotion_type": "APP",
        "alive_in_store": "YES",
        "preview_url": "https://play.google.com/store/apps/details?id=xxxxxxx",
        "product_name": "Test",
        "package_name": "com.tencent.mm",
        "description": "Test",
        "icon": "f7c970d0d24c71d84d15a78f29042323",
        "platform": "ANDROID",
        "category": "BUSINESS",
        "app_size": "12.13",
        "min_version": "1.0.0",
        "maintain_by": "ADV"
      },
      {
        "campaign_id": 1235,
        "is_coppa": "YES",
        "campaign_name": "Test",
        "promotion_type": "APP",
        "alive_in_store": "YES",
        "preview_url": "https://play.google.com/store/apps/details?id=xxxxxxx",
        "product_name": "Test",
        "package_name": "com.tencent.mm",
        "description": "Test",
        "icon": "f7c970d0d24c71d84d15a78f29042323",
        "platform": "ANDROID",
        "category": "BUSINESS",
        "app_size": "12.13",
        "min_version": "1.0.0",
        "maintain_by": "ADV"
      }
    ]
  }
}

이전의

API: 캠페인 관리하기(기술 가이드)

API: 캠페인 생성하기(기술 가이드)

최근 수정됨: 2026-08-06

개요