Skip to main content

Monetization

Endpoint: https://app.partnerboost.com/api.php?mod=medium&op=monetization_api

Auth: Partner API authentication

Required parameters

KeyDescription
tokenChannel API token

Optional parameters

KeyDescription
typeReturn format: json (default) or xml
brand_typeBrand types: TikTok, DTC, Amazon, Walmart, Indirect
brand_idBrand ID, a series of numbers, like 66303
approval_typeFilter by approval type: Auto, Manual
offer_typeFilter by brand pricing model: CPS, CPA, CPC, CPL, CPX, CPM
relationshipFilter by your current brand relationship: Joined, Pending, Rejected, No Relationship
categoriesFilter by your current brand relationship: Joined, Pending, Rejected, No Relationship
countryFilter by country. Please enter two-letter country code. Example: US, CA, FR, UK, AU
pageCurrent page index
limitNumber of campaigns shown per page - max 2000 campaigns per page

Return fields

KeyDescription
brand_typeBrand types: TikTok,DTC, Amazon, Indirect, Walmart
total_mcidTotal number of brands called
total_pageTotal number of pages
brand_idBrand ID, a series of numbers, like 66303
mcidUnique identifier for the brand, a series of characters, like ulike0
midDeprecated, for removal. This parameter is subject to removal in a future version.
merchant_nameBrand Name
comm_rateCommission Rate
comm_detailCommission Detail
site_urlBrand homepage url
logoBrand Logo
categoriesBrand categories
tagsSubcategories and keywords of the brand
offer_typeBrand pricing model
network_partnerNetwork of the Affiliate Program
avg_payment_cycleThe average days it takes for commissions approved and paid by the brands
avg_payoutAverage commission rate on PartnerBoost. Formula: (Commission)/(Sale Amount)
monthly_visitsNumber of monthly visits
countryCountry
support_regionSupport Region
brand_statusBrand Status (Online or Offline)
datetimeDate joined/removed from the program
relationshipYour brand relationship
tracking_urlYour campaign tracking link
tracking_url_shortYour campaign short link
tracking_url_smartYour campaign smart link
RDCookie duration
site_descDescription of the program
filter_wordsFilter words
currency_nameThe currency the program is set to track in
allow_smlWhether or not deep linking is enabled
post_area_listThe country the brand will ship to
rep_nameThe name of the contact for the brand
rep_emailThe email address for the brand
support_couponordealWhether brand allows traffic from coupon or deal sites. 1 = allowed. 0 = not allowed. - = unknown.
support_storefront_linkWhether brand supports Amazon storefront link. true = allowed. false = not allowed.

Request:

{
"token": "YOUR_CHANNEL_TOKEN",
"brand_type": "DTC",
"relationship": "Joined",
"page": 1,
"limit": 100
}

Response (abbreviated):

{
"status": { "code": 0, "msg": "Success" },
"data": [
{
"brand_id": "66303",
"mcid": "example",
"merchant_name": "Example Brand",
"brand_type": "DTC",
"offer_type": "CPS",
"relationship": "Joined",
"tracking_url_smart": "https://partnerboost.com/smart/example"
}
]
}

Use results with datafeed/list and the Link Builder for monetized URLs.