1. Sovrn Commerce
  2. Troubleshooting & FAQ

How to Use the Sovrn Commerce Developer Center for Your API Needs

Find out how you can to test Sovrn //Commerce APIs in the Developer Center with the help of our "Test it Out" tool.

Sovrn //Commerce, formerly VigLink, maintains an interactive Developer Center. With the help of this tool, you can explore various integration methods that can work across websites (e.g. blogs, forums, web apps), mobile apps, and even desktop apps.

Rate Limits

The Transaction Reporting API and the Product Metadata API are the only two API tools that have a rate limit in place, each at one request per second.

There are not currently any API limits in place for the other tools, but that could always change in cases of abuse.

How to test the APIs

Sovrn //Commerce, formerly VigLink, offers many different APIs you can use to uncover more detail or help power your project. But let’s say you want to see the type of information it gives you; and if the data is what you’re looking for, how it would look, or even, how to use it before deciding if it’s the API you will use.

Luckily, we have a “Try it Out” section that requires zero coding at all -- just some information that can be found in your Sovrn //Commerce account settings.

With most of our API Documentations, there will be a “Try it Out” section located at the very bottom of the page. In these sections, you can test to see exactly what information will be provided, the different filters or parameters that you can use, and of course, the results itself.

Here’s a link to our API Documentation.

Before diving in, let’s find out where you can locate the two kinds of information that is crucial to “Test it Out”. The two kinds of information needed is API Key and Secret Key.

The path to this information is Account > Sites > your domain name > “key” icon under Actions.


**Do not share your Secret Key**

Now that you have found your secret key, let’s take a look at the Sovrn Transaction Report API documentation.

Scroll to the bottom of the page and you’ll see:


This is the area where you’ll be placing your Secret Key. Click on the green key icon and a field will appear for you to type in your Secret Key. The format of how this should be typed is the word “secret”(without quotations), then a space, and then your Secret key. So, it should look something like this:

secret 123yoursecretkey123


  1. In order to run this “Try it Out”, you’ll need the minimum of these two fields, which is what the red asterisks are denoting. The date format should be YYYY/MM/DD.

Press “Try it” below all the field boxes and that’s it! You should see your results in a window:


Now that you have the basics, you’ve might’ve noticed the other boxes with fields you can fill in. These are the different parameters you can use to be more specific with the data being returned. These parameters are outlined at the top of API documentation to let you know what type of information it is.

Using the same Transaction API with the same dates, try searching for a “merchantName”.

Please note that the format and punctuation have to be exactly what we have in our system. So we recommend running a basic call as we did above to familiarize yourself with the format the results are in. 

For example, if we want to filter down by Walmart, we’ll have to type it in the field exactly how we saw it in the report:



Press “Try It” and it will only return results with the merchant name “Walmart”.

This strategy will work for the other parameters in this Transaction API or another API you decide to “Try it Out”. Using the results from the initial data return, you can learn what the field is looking for and how to fill it in to narrow down your dataset to get exactly what you’re looking for.

Need help with one of the Sovrn Commerce APIs? Reach out to the Sovrn Support team at publishersupport@sovrn.com for assistance!