Context
Downloading WEkEO data is free of charge, you only need an account (sign up!). However, there is a limitation in place that will restrict the amount of requests and orders a user can make within a one-hour period.
This article aims to detail how this limitation is applied to the hda Python package and the HDA REST API.
Limitations in hda Python package
If you use HDA API Python package a limitation is made when using the matches.download() function: you are limited to 100 downloadable items per hour via the matches.download() function. For example if print(matches) returns SearchResults[items=21,volume=36.3MB,jobId=5RNtj0pbopSKws8P2WU7mmNMey8] then matches.download() will download 21 items so your quota will be 21/100
You get back each of your actions 1 hour after you have done them. Let's take the example of downloading an item at 2pm and another one at 2:30pm, then at 2:30pm your quota is at 2/100, at 3pm your quota is at 1/100 and at 3:30pm your quota is at 0/100.
💡WEkEO Pro Tip: re-running the matches.download() function without changing matches does not count in the quota again.
In case you want to download more than 100 items then you can proceed as in this example: let's say you have 149 items to download, you run matches[0:100].download() to download the first 100, then 1 hour later you run matches[100:150].download() to download the next 49 items.
📌 Note: if you want to increase your quota to download more items per hour, you can contact the WEkEO support. Don't hesitate to do "Talk to a person 👤" if you're chatting with our AI Agent Neo.
Use of the HDA REST API via cURL or Wget
If you use the HDA REST API a limitation is made when using the operation POST dataaccess/download: you are limited to 100 downloadable items per hour via the POST dataaccess/download operation. Here is an exemple with cURL command
You get back each of your actions 1h after you have done them. Let's take the example of ordering an item at 2pm and another one at 2:30pm, then at 2:30pm your quota is at 2/100, at 3pm your quota is at 1/100 and at 3:30pm your quota is at 0/100.
💡WEkEO Pro Tip: re-running a POST dataaccess/download operation already performed does not count in the quota again.
📌Note: if you want to increase your quota to download more items per hour, you can contact the WEkEO support. Don't hesitate to do "Talk to a person 👤" if you're chatting with our AI Agent Neo.
What's next?
We are user-driven and we implement users' suggestions, so feel free to contact us:
through a chat session available in the bottom right corner of the page
via our contact webpage
via e-mail to our support team (supportATwekeo.eu)
Regardless of how you choose to contact us, you will first be put in touch with our AI Agent Neo. At any time, you can reach a member of the WEkEO User Support team by clicking on "talk to a person" via chat, or by naturally requesting it in reply to Neo's email.