API Tools and the Developer Center

Last Updated September 30, 2019

Sovrn //Commerce, formerly VigLink, maintains an interactive Developer Center at https://viglink-developer-center.readme.io. Here, you can explore ways 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 Documentations: https://viglink-developer-center.readme.io/docs

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.

commerce-api-and-developer-center-1

**Do not share your Secret Key**

Now that you have found your secret, let’s take a look at our new Transaction Report API documentation: https://viglink-developer-center.readme.io/docs/transaction-reporting

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

commerce-api-and-developer-center-2

  1. 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

commerce-api-and-developer-center-3

  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:

commerce-api-and-developer-center-4

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”.

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:

commerce-api-and-developer-center-5

commerce-api-and-developer-center-6

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.

How satisfied are you with this article?

  • Not at all satisfied
  • 1
  • 2
  • 3
  • 4
  • 5
  • Completely satisfied