Brand List Item
Brand or advertiser record returned by GET /api/brands-list.
Fields
merchant_id
Integer
Merchant identifier associated with the brand. Not permanent; may change when campaign or merchant configuration is updated.
offer_id
MD5 hash (32-character string)
Same offer_id as Revenue Share. Use it to match Brand List with Revenue Share.
campaign_id
Integer
Campaign identifier associated with the brand's current tracking campaign. Not permanent; may change when the underlying campaign is updated.
domain
string
The official primary website domain of the brand or advertiser. Stable unique identifier; appears at most once per Brand List response.
brand_name
string
The PubAdHub brand name for the merchant.
merchant_category
string
The brand/merchant category. May be null if no category is assigned.
verification_status
string
Brand status. Returned as verified for active brands and unverified for inactive brands. Brand List responses currently include active brands only, so this value is verified.
click_url_homepage
URL
Affiliate tracking URL that directs users to the brand's main homepage. Replace {PublisherClickID} (required) and optional subi, psorc, pcat, and subid1–subid5.
click_url_deeplink
URL (optional)
Affiliate tracking URL that sends users to a specific page (product, category, offer). Replace {DeepLink} and {PublisherClickID}; subi, psorc, pcat, and subid1–subid5 are optional.
country_code
string
Country or countries where the offer is valid or allowed (ISO country codes like US, CA).
restricated_traffic
string / array
Types of traffic sources or promotional methods that are not allowed for this brand. Field name spelling is from the PDF.
new_deal
0 or 1
Indicates whether the brand or offer is newly added (1 = new deal, 0 = existing deal)
last_updated_date
Null or YYYY-MM-DD
The most recent date when this record was updated (YYYY-MM-DD format). Can be NULL if not updated.
commission_rate
Commission in Percentage or Currency
Commission rate or descriptive text such as "10% CPA". Null when flat_fee applies.
flat_fee
Currency amount (optional)
Fixed commission amount for qualifying transactions. Returned only for cashback/flat-fee-enabled publishers when the brand uses a flat-fee model. When present, commission_rate is null.
| ATTRIBUTE | TYPE | DESCRIPTION |
|---|---|---|
| merchant_id | Integer | Merchant identifier associated with the brand. Not permanent; may change when campaign or merchant configuration is updated. |
| offer_id | MD5 hash (32-character string) | Same offer_id as Revenue Share. Use it to match Brand List with Revenue Share. |
| campaign_id | Integer | Campaign identifier associated with the brand's current tracking campaign. Not permanent; may change when the underlying campaign is updated. |
| domain | string | The official primary website domain of the brand or advertiser. Stable unique identifier; appears at most once per Brand List response. |
| brand_name | string | The PubAdHub brand name for the merchant. |
| merchant_category | string | The brand/merchant category. May be null if no category is assigned. |
| verification_status | string | Brand status. Returned as verified for active brands and unverified for inactive brands. Brand List responses currently include active brands only, so this value is verified. |
| click_url_homepage | URL | Affiliate tracking URL that directs users to the brand's main homepage. Replace {PublisherClickID} (required) and optional subi, psorc, pcat, and subid1–subid5. |
| click_url_deeplink | URL (optional) | Affiliate tracking URL that sends users to a specific page (product, category, offer). Replace {DeepLink} and {PublisherClickID}; subi, psorc, pcat, and subid1–subid5 are optional. |
| country_code | string | Country or countries where the offer is valid or allowed (ISO country codes like US, CA). |
| restricated_traffic | string / array | Types of traffic sources or promotional methods that are not allowed for this brand. Field name spelling is from the PDF. |
| new_deal | 0 or 1 | Indicates whether the brand or offer is newly added (1 = new deal, 0 = existing deal) |
| last_updated_date | Null or YYYY-MM-DD | The most recent date when this record was updated (YYYY-MM-DD format). Can be NULL if not updated. |
| commission_rate | Commission in Percentage or Currency | Commission rate or descriptive text such as "10% CPA". Null when flat_fee applies. |
| flat_fee | Currency amount (optional) | Fixed commission amount for qualifying transactions. Returned only for cashback/flat-fee-enabled publishers when the brand uses a flat-fee model. When present, commission_rate is null. |
Example Payload
{
"merchant_id": 101,
"offer_id": "38b3eff8baf56627478ec76a704e9b52",
"campaign_id": 501,
"domain": "abc.com",
"brand_name": "ABC",
"merchant_category": "Home and Living",
"verification_status": "verified",
"country_code": "US",
"restricated_traffic": [],
"new_deal": 0,
"last_updated_date": "2026-02-11",
"commission_rate": null,
"flat_fee": "$20"
}