Introduction
RFH Insights offers many possibilities to conduct research into the price development of products on the clock via the Market View.
However, there are also users who would like to use this data in their own reports or in their own application, for example to automatically determine a sales strategy themselves.
For this specific purpose, a number of APIs have been developed, which a grower or buyer can use to retrieve average prices of auctioned products. The grower has the choice to do this only for the products that he sells on the clock himself, or to retrieve this for any available product group.
The right to use these APIs is linked to an RFH Insights subscription.
Documentation about the API
The technical documentation with informatoin, what exactly can be passed on as a parameter, and which data the APIs returns, can be found via the following link:
Here you will find 3 different functions:
average-auction-prices: this function returns the average auction price for each auctioned product, per location and main characteristic. Auctioned quantities are also included if there are three or more different suppliers. For this function, an RFH Insights Light subscription is sufficient.
average-auction-prices-overview: this can be used to retrieve the average prices per location/product/main characteristic per product group. The three grower rule also applies here. This function requires at least an RFH Insights Basic subscription.
buyers/average-auction-prices: the same option as above, but only available for customers with a RFH Insights Buyers subscription. Quantities are only shared with buyers if there are more than five different suppliers.
Using APIs
Connecting to RFH Insights APIs works the same as connecting to Floriday APIs. Many software companies active in floriculture already use have access and are using these APIs. This works via their own unique key (ClientID).
More information about which companies are already active, or how a company can register for this, can be found at the following links:
To prevent over-requesting and therefore overloading, a rate limit is used on the API functions.
From Monday to Friday between 06:00 AM and 12:00 PM (noon), one call can be made every 5 seconds. At all times outside of that, this can be done once per second.
How do you make a call?
If you want to use an API, you need a token. A token can be requested by the sofware supplier (with his ClientID).
In addition to the token, an API key is also required. If a grower or buyer in Floriday links to a specific software supplier, the API key that is then created can be used for this. The API key then indicates for which organization the API call is made.