Bidding API
About the product
The Bidding API is a Heureka service that provides up-to-date data from the Heureka product catalog. Important information for effective bidding that can be seen on the product detail is part of the API.
Target
More than half of the performance capacity of the Heureka servers is consumed by automated browsing of the Heureka website. We want to limit the crawling of the Heureka website and provide indemnification in the form of a paid API with added value.
API documentation
Always up-to-date API documentation is available at https://api.heureka.cz/bidding_api/v1/apidoc
The documentation includes call and response structures with examples of returned results. Possible return values of individual attributes are visible in the “Structure” tab. The tree structure is expandable when clicked and contains a help hint when hovering over the mouse. It is possible to call the API interactively after filling in the token assigned to you in the access_key key.
Endpoints for API calls
Heureka.cz catalog https://api.heureka.cz/bidding_api/v1/apidoc
Heureka.sk catalog https://api.heureka.sk/bidding_api/v1/apidoc
Client-side implementation
JSON-RPC is a stateless remote procedure call (RPC) protocol. To implement the API on your end, it is possible to use the available libraries for the given programming language. In Python, you can take inspiration from the sample below. We will assign you a key to communicate with our API servers, which you will use as the access_key attribute in the parameters.
https://pypi.org/project/json-rpc
Cache on Heureka’s side
In order to improve the speed of responses, the shipping price data and category list are cached on Heureka’s side for 1 hour in the category.index method.
Limits
The servers are hosted outside the cloud and are not inflatable. The minute limit for the number of calls for each key is 10,000 so that there is no peak load on the cluster. We’d appreciate it if you could spread out the API calls smoothly over time.
Notifications
Throughout the month, we will send you notifications about the ongoing status of the number of API calls for your key.
Billing
Backwards for the previous month, we will send you invoices generated for the number of API calls according to the tariff used.
FAQ – the most frequently asked questions
How does API activation work?
First, you need to confirm the contract for ordering this service, then you will be provided with access/token, documentation, and other necessary information. Subsequently, it is adequate to implement the API.
Will I receive a notification about the ongoing status of the calls?
Yes, you will. A weekly report with the number of calls will be sent to your email.
Are you interested in the Bidding API, or do you have additional questions? Do not hesitate to contact me by email: [email protected].