Context
Downloading WEkEO data is free of charge, you only need an account (sign up!). However, there are limitations in place that restrict the number of requests and orders a user can make within an hour, as well as over a one-month period.
This article aims to detail how these limitations are applied to the hda
Python package, the HDA REST API and the EOCanvas tool.
π Note: if you need to increase your quota temporarily to download more items, please contact the WEkEO support.
Summary table
Service | Quota | Can request increase* |
| 100/h | β |
HDA REST API | 100/h | β |
EOCanvas (1) | 10/h | β |
EOCanvas (2) | 100/month | β |
*Indicates if you can ask User Support for a temporary quota increase
Quota limitations
hda
Python package
The quota for the HDA Python package is 100 downloadable items per hour.
This limitation stands for the download()
function. For example, if the search returns:
SearchResults[items=21,volume=36.3MB,jobId=5RNtj0pbopSKws8P2WU7m]
you will download 21 items and your quota will be 21/100
.
In case you want to download more than 100 items, let's say 149 items, you can proceed as follows:
Run
matches[0:100].download()
to download the first 100 items.Wait for 1 hour.
Run
matches[100:150].download()
to download the next 49 items.
π‘WEkEO Pro Tip: re-running the matches.download()
function without changing matches
does not count in the quota again.
HDA REST API
The quota for the HDA REST API is 100 downloadable items per hour.
The limitation stands for the POST dataaccess/download
operation. Here is an exemple with cURL command.
π‘WEkEO Pro Tip: re-running a POST dataaccess/download
operation already performed does not count in the quota again.
EOCanvas
There are 2 distinct quotas for the EOCanvas tool:
10 downloadable items per hour
100 downloadable items per month
Quota retrieval
You get back each of your actions 1 hour after launching them.
Let's take an example for illustration:
You download 1 item at 2pm: quota is
1/100
You download 2 other items at 2:30pm: quota is
3/100
At 3pm (i.e. 1 hour after first download): quota is
2/100
At 3:30pm: quota is
0/100
What's next?
Several articles are available in the WEkEO Help Center, but if you have any questions, issues or suggestions, feel free to contact us through a chat session available in the bottom right corner of the page.