Skip to main content

Limitations of Requests and Orders

This article lists the different download quotas set by WEkEO to ensure high-quality service for all users.

Alexandre avatar
Written by Alexandre
Updated over 2 weeks ago

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*

hda Python package

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:

  1. Run matches[0:100].download() to download the first 100 items.

  2. Wait for 1 hour.

  3. 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.

Did this answer your question?