Python API

Example usage for interacting with the api in your Python code:

from eodag import EODataAccessGateway

dag = EODataAccessGateway()

search_results = dag.search(
    collection='S2_MSI_L1C',
    geom={'lonmin': 1, 'latmin': 43.5, 'lonmax': 2, 'latmax': 44}, # accepts WKT polygons, shapely.geometry, ...
    start='2021-01-01',
    end='2021-01-15'
)

product_paths = dag.download_all(search_results)

This will search for Sentinel 2 level-1C products on the default provider and return the found products first page and an estimated total number of products matching the search criteria. And then it will download these products. Please check the Python API User Guide for more details.

Command line interface

Start playing with the CLI:

• To search for some products:

  eodag search --collection S2_MSI_L1C --box 1 43 2 44 --start 2021-03-01 --end 2021-03-31

  The request above searches for S2_MSI_L1C collections in a given bounding box, in March 2021. It saves the results in a GeoJSON file (search_results.geojson by default).

  Results are paginated, you may want to get all pages at once with --all, or search products having 20% of maximum coud cover with --cloud-cover 20. For more information on available options:

  eodag search --help

• To download the result of the previous call to search:

  eodag download --search-results search_results.geojson

• To download only the result quicklooks of the previous call to search:

  eodag download --quicklooks --search-results search_results.geojson

• To list all available collections and supported providers:

  eodag list

• To list available collections on a specified supported provider:

  eodag list -p creodias

• To see all the available options and commands:

  eodag --help

• To print log messages, add -v to eodag master command. e.g. eodag -v list. The more v given (up to 3), the more verbose the tool is. For a full verbose output, do for example: eodag -vvv list