メニュー

API: キャンペーンリスト取得（テクニカルガイド）

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

campaign listを取得し、campaign_id、campaign_name、package_nameに基づく照会をサポートします。

Request address

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

Request method

GET

Request example

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 }

Request Parameter

Fields	Type	Explanations	Default Value	Examples
campaign_id `Optional`	int	campaignのUnique id。複数campaignの場合はカンマで区切ります。 Note: 1回の検索で指定できる最大数は50です。	—	`"1230,1231,1532"`
campaign_name `Optional`	string	campaignの短い説明	—	`"campaign_test"`
package_name `Optional`	string	appのPackage name	—	`"test"`
offer_id `Optional`	int	offerのUnique id	—	`1234"`
offer_name `Optional`	string	offerのUnique name	—	`"offer_test"`
offer_uuid `Optional`	string	自動生成されるUnique offer name	—	`"ss_offer_test"`
page `Optional`	int	Page	1	`1`
limit `Optional`	int	各pageのLimit。Maximum: 50 >50の場合は50を返します	10	`15`

Response

Fields	Type	Explanations
code	int	200 codeはsuccessです。その他はfailです。
msg	string	successの場合は"success"を返します。failの場合は詳細なerror infoを返します。
data	json	successの場合はcampaign dataを返します。failの場合は詳細なerror infoを返します。
page	int	current page
limit	int	quantity limit
total	int	total amount
list	array<json>
campaign_id	int	campaignのUnique ID
campaign_name	string	追加したCampaign name
is_coppa	string	COPPA settingのvalue
promotion_type	string	設定したPromotion type
alive_in_store	string	“alive in store”に設定したvalue
preview_url	string	campaignに追加したPreview link
product_name	string	Ads objective name
package_name	string	プロモーションしたいapplicationのIOS app store idまたはbundle id
description	string	ads objectiveのDescription
icon	string	iconまたはlogoのMd5
platform	string	campaignのPlatform
category	string	campaignのCategory
app_size	string	applicationのSize
min_version	string	campaignで設定したminimum system version
maintain_by	string	offerを変更する権限です。maintain_by="AM"の場合、campaignまたはofferのdetailsのみ確認できます。maintain_by="ADV"の場合、campaignまたはofferのsettingを自由に変更できます。
status	string	Campaign Status。Enum valueは[ENUM - Campaign Status]を参照してください

Response Example

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

概要