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).
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 product data!
Make sure you are logged in and navigate to the dashboard.
Click on the green button "request data"
Step 1: Request products
At first choose the country you want to get the data from.
Next you can select a data source from the dropdown "Source" Depending on the country you have chosen in the last step, the available sources differ.
At "topic" you can choose different topics. If you want to get all product and offers of a gtin and the names of the shops who offer the product on this source. Depending on the source we have some other offers to request.
Do you have a barcode of one of your products at hand? If so, then choose GTIN in the next dropdown menu.
If you don't have one, you can enter a combination of a brand and product name, like "Apple iPhone 6s." In this case, please change the dropdown titled "key" from "gtin" to "term."
When you choose ID as a key, you need the individual source ID of a product in the case of request offers of this source or category ID´s in case of requesting e.G. "Bestseller"
At advanced Options you can choose the age of the data you want to request, the number of pages and the condition (used or new).
If your country is not in the list or you are looking for a source that is not in the list, please let us know. We have more sources available and expand on request.
There are more options; just ignore them for now. Next, click the "Request" button to create a data collection job.
You should see the status of your job in percentage:
Step 2: Wait until we have collected all the data for you
So what happens now is that our system visits the data source you have selected, kind of like a human would do, searches the product and extracts the relevant information.
This takes a brief moment. A single product would usually take several seconds, sometimes a few minutes. Because our system works highly parallelized, a thousand products will also usually just take a few minutes.
When you click on the green Button you can check the data when you click "view".
There is a status field here. It starts being "new," works its way over "working" and "finishing" all the way to "finished."
The job's results can only be downloaded, when the job's status is "finished." At that point, we can continue with the next step.
Step 3: Download the product data
Below the last response, you find a third headline titled "Load the job's response." Again, your job's ID has been filled into the text field for you. Now you have a bunch of options, depending on the format you want Price API to provide the product data to you:
- Show JSON: This is a data format popular with programmers. This option will display the data on the dashboard.
- Download JSON, download XML: These are both popular with programmers. This time the data would be downloaded as a file instead of being displayed on the web interface.
- Download Excel or CSV (Columns): This and the next option are popular with people using spreadsheets. In the columns variant, there is one row per product. It has a variable amount of columns and every offer (shop name, price, shipping costs, availability etc.) is concatenated to the right.
- Download Excel or CSV (Rows): In this format, each offer has its own row. So a product that is offered by ten shops will occupy ten rows. The product information will be redundant and only the offer information is different. This has a fixed number of columns and works well with Pivot Tables.
After you have the data, the fun and valuable part begins. Will you build a system that sets perfect prices? Will you identify your competitor's strategy? We'd love to discuss your use case with you. Start a chat or call us anytime.
That's it. We've covered all the steps you (or a program on your behalf) needs to take to access millions of products on hundreds of data sources, all in the same standardized format:
- Request products (you can request more than one at once)
- Wait until the job is finished
- Download the data in a format that suits you
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. Maybe test out another data source.