❗️
Registration Required
The Sovrn Commerce Coupon API is a closed API provided by our network partner. This API allows you to access Coupon and Deal feeds for merchants that you are promoting on your site. Sovrn Commerce will request approval on your behalf, and a review of your site could take 3-5 business days.
Please visit our Coupon Onboarding Guide for Commerce to get started.

❗️
Authorization
To query this API, include a Secret Key in the Authorization header of your request. The value of the header must be formatted as secret {SECRET_KEY}, ensuring that the word secret is followed by a space before the key itself.
For details on generating a Secret Key for your site, visit our Authorization guide.

This API is rate limited and coupons are updated daily. The suggested usage is to perform a daily export of the data to be ingested into your own system.

Field	Description
Category	Category of merchandise the merchant sells.
Rating	Deal Ratings are assigned to every offer. They can be used to aid in the placement of coupons and deals on your merchant pages based on offer value and potential of customer appeal. Ratings start at 1 (lowest value) and higher is better.
PrimaryCountry	The country the merchant is primarily targeting.
ShipToCountries	The country or countries the merchant will ship to. Country name, comma delimited.

FAQ:
Q: How can I test this in my web browser?
A: You can download a browser extension called mod header here:

https://chrome.google.com/webstore/detail/modheader/idgpnmonknjnojddfkpgkljpfnnfcklj?hl=de

The extension allows you to add a secret key to your request. Under the "Value" section in the plugin, paste "secret 1234abcd" without quotes, and replace the 1234abcd with one of the secret keys from your Sovrn account. You can find your secret key in your site settings page:

https://commerce.sovrn.com/publisher/sites

Now you can test the API by making a request with your web browser.

When you are done testing be sure to disable the mod header extension as it can interfere with browsing websites.