The Merchant API let’s you determine approval status and access estimated commission rates at scale.

🚧

Authorization Header

You must add authorization headers to this request. Please see the Authorization section for further details.

Merchant Search:

You can search through over 50,000 merchants working with Sovrn Commerce using the following url.

https://publishers.viglink.com/api/merchant/search?

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.

Sample call:

curl -i -X GET    -H "Authorization:secret {SECRET KEY}"  'https://publishers.viglink.com/api/merchant/search?domain=nike.com'
require 'httparty'

headers = {
  Authorization: "secret <secret key>"
}

params = {
  domain: "nike.com"
}

url = "https://publishers.viglink.com/api/merchant/search"

response = HTTParty.get(url, headers: headers, query: params)

Potential Categories

name code
Consumer Electronics CE
Automotive AU
Fashion & Accessories FS
Health & Beauty HB
Real Estate RU
Art & Entertainment AE
Sports & Fitness SF
Self-Help SH
Travel TV
Financial Services FI
Pets PT
Cell Phones & Mobile CM
News, Books & Magazines BK
Education ED
Other OT
Dating DT
Music & Musicians MM
Food & Drink FD
Home & Garden HG
Adult & Gambling AG
Career & Employment CA
Collectibles CB
Online Services EM
Family & Baby FB
Firearms and Hunting FH
Gaming GM
Jewelry & Watches JW
Lifestyle LF
Motorcycles & PowerSports MP
Shopping & Coupons SP
Toys & Hobbies HO
Cameras & Photo CP
Undefined UN

Response Fields

Field Sub-Field Description Example
page page returned 1
totalPages total number of pages with records 1
totalRecords total records displayed on this page 33
merchants id Sovrn Commerce specific unique identifier 25700
groupId Sovrn Commerce specific group identifier 34
name name of the merchant nike.com
groupName normalized name of merchant nike
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"}][{"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 an array of the domains that can be affiliated ["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"=>"%"}
Language
Credentials
Header
Click Try It! to start a request and see the response here!