get https://publishers.viglink.com/api/merchant/
The Merchant API let’s you determine approval status and access estimated commission rates for a merchant.
Authorization Header
You must add authorization headers to this request. Please see the Authorization section for further details.
Endpoint
All merchant API requests start with “https://publishers.viglink.com/api/merchant/”
Rate Limit
Your calls will be limited to 1 query per 3 seconds. If you exceed our rate limit your queries will be throttled and you will get no response.
Individual Merchant Query:
To query a single merchant, add the merchant ID to the path of the url.
https://publishers.viglink.com/api/merchant/{merchantId}
Sample call:
curl -i -X GET -H "Authorization:secret {SECRET KEY}" https://publishers.viglink.com/api/merchant/342'
url = "https://publishers.viglink.com/api/merchant/342"
headers = {
Authorization: "secret <secret key>"
}
response = HTTParty.get(url, headers: headers)
Response Fields
Field | Description | Example |
---|---|---|
id | Sovrn Commerce specific unique identifier | 25700 |
name | name of the merchant | nike.com |
updateDate | last date the merchant program was updated in system | 2015-03-11 |
createDate | date the merchant was created in the system | 2011-09-23 |
insider | increased commission rate as part of the Insider Program | false |
industryTypes | merchant vertical classification | [{"code"=>"SF", "name"=>"Sports & Fitness"}] |
affiliateCPA | CPA program | false |
affiliateCPC | CPC program | true |
approved | can your campaign earn money on this merchant program | true |
domains | domains | ["thedraw.nike.com", "nikefactorystore.nike.com", "jobs.nike.com", "niketown.nike.com", "news.nike.com", "insider.nike.com", "nikeid.nike.com", "go.nike.com", "content.nike.com", "nikerunning.nike.com", "photoid.nike.com", "nike.com", "m.nike.com", "store.nike.com", "nikelab.nike.com", "secure-nikeplus.nike.com", "producttesting.nike.com", "secure-store.nike.com", "niketeam.nike.com", "images.nike.com", "click.official.nike.com", "help-en-us.nike.com", "nikeplus.nike.com", "secure-images.nike.com"] |
countries | a comma separated string of the two letter country codes where this merchant accepts traffic | us,ca,uk |
merchantSensitiveTypes | classification of publishers that this merchant doesn’t work with | Non CPC |
rates | an array of the commission rate information, can return different levels of commission, cpc rates, cpa rates, etc... For some merchants we will display a calculated commission rate. This is the average commission rate earned by our publishers for this particular merchant. | {"min"=>6.0, "max"=>6.0, "type"=>"%", "description"=>"commission(US)", "typeName"=>"%"} |