API: Managing Publishers as Advertiser (Technical Guide)

Label：API ,API key ,manage publishers ,technical guide ,developer guide

You need to use your Mintegral token to manage your offers. For more details, please check Token.

Use this guide to manage publishers (also called "mtgid") as an advertiser for your offers. This is an advanced feature so if it returns a “permission denied” message，please contact your account team to get access.

You can contact your account manager or email us at growth@mintegral.com (outside of the United States) or growth.us@mintegral.com (in the United States) for assistance.

Request address

https://ss-api.mintegral.com/api/open/v1/offer/target

Request method

PUT

Request example

json Copy

PUT /api/open/v1/offer/target
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{ 
  "offer_id": 1234, 
  "option": "ENABLE", 
  "mtgid":  "mtg1127838375" 
}

Request Parameter

Fields	Type	Explanations	Default Value	Examples
offer_id	int	Offer ID	—	`1234`
option	string	Status for publishers under offers. Enum value: `"ENABLE"`, `"DISABLE"`, `"ALLOW_ALL"` `ENABLE`: remove specific mtgid from black list. `DISABLE`: Add specific mtgid into blacklist. `ALLOW_ALL`: remove all mtgid from black list.	—	`"DISABLE"`
mtgid	string	mtgid to be set status of. Only when option is set to `"ALLOW_ALL"`, mtgid can be set to null, if set null, all blacklist settings will be removed. Separate with commas for multiple mtgid with maximum number of 3000. Note: This api uses the full update method, please submit the complete settings.	—	`"mtg1127838375"`

Response

Fields	Type	Explanations
code	int	200 code, is success. Others, are fail.
msg	string	If success, return to "success". If fail, return to detailed wrong info.
data	json	If success, return null. If fail, return to detailed wrong info.

Response Example

json Copy

{
  "msg": "success",
  "code": 200,
  "data": null
}

API: Updating Promotion Status For Offers

API: Updating Tracking URL (Technical Guide)

Last modified: 2025-08-28

Outline