Coupons

Export thousands of active coupons from our growing list of supported networks and retailers.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
❗️

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.

FieldDescription
CategoryCategory of merchandise the merchant sells.
RatingDeal 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.
PrimaryCountryThe country the merchant is primarily targeting.
ShipToCountriesThe 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.

Query Params
string

Get coupons valid for a specified domain. Cannot work with parameter: merchantGroupId at the same time

string

Get coupons valid for a specified merchantGroupId. Cannot work with parameter: domain at the same time

string

Get coupons that are valid greater than or equal to the startDate specified. Format: yyyy-mm-dd. e.g. 2019-02-06. The startDate cannot be in the future.

string
Defaults to json

This changes the format of the response. We currently support 'json', 'csv' and 'clipper'. 'clipper' exports a csv that is compatible with the popular Clipper wordpress coupon plugin: https://www.appthemes.com/themes/clipper/

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/plain