Make your first request

Use the web app to request a product and download the results.

This guide takes you through the basic functionality of Price API. If at any point you have questions, please contact us via our chat system (lower right corner).

Prerequisites

This guide assumes that you have a free account at Price API and that you are currently logged in to it. If you don't have an account yet, start your free trial now.

Let's request some product data!

Make sure you are logged and navigate to the version 2 request tool.

2560

Step 1: Select country & source

From the dropdown, select the country and source you want Price API to collect data from. The available sources per country varies.

Step 2: Select the kind of information

The so-called "topic" specifies which kind of information you are interested in. For repricing, choose "Product And Offers.". Topic names are pretty similar to the page you'd see on the source. Following is a short information about what basic topics mean:

  • Search Results: It will return information from search_results page( page you get when you use "search bar" to search a product on the main page).
  • Offers: It return information from the offer's page that has a list all offers.
  • Product: It will return information available on the product page of the source that has all the selected product's information.
  • Product And Offers: This is a topic that will have combination of all three topics mentioned above. It picks the first product from search result's page, returns information about the picked product and offers related to it.
1166

Step 3: Identify the products

With Price API, you can specify the products you are searching for by. You set this in the "Key" dropdown.

πŸ“˜

Barcodes, GTIN, EAN, UPC and JAN

See article Barcodes, GTIN, EAN, UPC and JAN to find out what these are and where to find them for your products.

Pros: Will give you a high matching rate, works across sources
Cons: Requires you to have these identifiers in your data

Example: 00190198791757

πŸ“˜

Source's own identifiers

All sources assign their own identifiers to well-known products. On Amazon, for example, this is the ASIN.

Pros: Will give you a perfect matching rate with the source
Cons: Requires you to collect these identifiers, only works for one source

Example: B07HBD26C7 for Amazon sources, 3396285766542281019 for Google Shopping Belgium

πŸ“˜

Keyword search terms

Any search term that leads to the results you are interested on the source. For a good matching rate, include more words, such as brand name, product name, model, and variant.

Pros: Easy to use, works across sources
Cons: Can have a lower matching rate

Example: apple iphone xs 64 gb gold

In "Values," you can identify up to 1,000 products. Write (or paste in) one value per line. E.g. if you selected "GTIN" from the "Key" dropdown, write one GTIN per line. If you selected "Term" from the "Key" dropdown, write one search term per line.

Then hit the "Request" button.

2410

Wait for the results & view or download

After pressing the "request" button, Price API will collect data from the source you selected. Depending on your settings, this information is likely collected fresh (and not taken from cache), so expect this to take a few moments. If you identified a single product, it will likely take a few seconds. If you identified a thousand products, it will likely take a few minutes.

As soon as the download icon appears, you can either view the results as JSON or XML in the browser or download them as Excel, CSV, JSON, or XML.

1194

Summary

That's it. We've covered all the steps you needs to take to access millions of products on hundreds of data sources, all in the same standardised format.

Of course, if you want to, you can integrate Price API into your system, so a program can do these steps on your behalf.


What’s Next

So now that you are proficient in the 1, 2, 3 of Price API, how about you try us at scale? Go find a list of your product identifiers and run a hundred of them through our system. Or try another data source.

Then, move on to our documentation about integration Price API: