Provider registration#

The providers usually require their user to register to their service. As a result, the users obtain a set of credentials (e.g. login/password, API key, etc.). These credentials need to be provided to eodag (see Configure EODAG). The list below explains how to register to each provider supported by eodag:

  • usgs: create an account here and then request an access to the Machine-to-Machine (M2M) API. Product requests can be performed once access to the M2M API has been granted to you.

  • theia: create an account here

  • peps: create an account here, then use your email as username in eodag credentials.

  • creodias: create an account here

  • onda: create an account here:

  • mundi: create an account here (click on “login” and then go in the “register” tab). Then use as apikey the Web Token provided here

  • ecmwf: create an account here. Then use email as username and key as password from here in eodag credentials. EODAG can be used to request for public datasets as for operational archive. Please note that for public datasets you might need to accept a license (e.g. for TIGGE)

  • cop_ads: create an account here. Then go to your profile and use from the section named “API key” the UID as username and API Key as password in eodag credentials. EODAG can be used to request for public datasets, you can browse them here.

  • cop_cds: create an account here. Then go to your profile and use from the section named “API key” use UID as username and API Key as password in eodag credentials. EODAG can be used to request for public datasets, you can browse them here.

  • sara: create an account here, then use your email as username in eodag credentials.

  • meteoblue: eodag uses dataset API which requires the access level Access Gold. Contact support@meteoblue.com to apply for a free API key trial.

  • cop_dataspace: create an account here

  • planetary_computer: most datasets are anonymously accessible, but a subscription key may be needed to increase rate limits and access private datasets. Create an account here, then view your keys by signing in with your Microsoft account here.

  • hydroweb_next: Go to https://hydroweb.next.theia-land.fr, then login or create an account by clicking on Log in in the top-right corner. Once logged-in, create an API key in the user settings page, and used it as apikey in EODAG provider auth credentials.

  • aws_eos: you need credentials for both EOS (search) and AWS (download):

    • Create an account on EOS

    • Get your EOS api key from here

    • Create an account on AWS

    • Once the account is activated go to the identity access management console

    • Click on user, then on your user name and then on security credentials.

    • In access keys, click on create access key.

    • Add these credentials to the user configuration file.

Note

EOS free account is limited to 100 requests.

  • astraea_eod, earth_search, usgs_satapi_aws: you need AWS credentials for download:

    • Create an account on AWS

    • Once the account is activated go to the identity access management console

    • Click on user, then on your user name and then on security credentials.

    • In access keys, click on create access key.

    • Add these credentials to the user configuration file.

Warning

A credit card number must be provided when creating an AWS account because fees apply after a given amount of downloaded data.

  • earth_search_gcs: you need HMAC keys for Google Cloud Storage:

    • Sign in using a google account.

    • Get or create HMAC keys for your user account on a project for interoperability API access from this page (create a default project if none exists).

    • Add these credentials to the user configuration file.