skip to navigation
skip to content

sentinelsat 0.12.1

Utility to search and download Copernicus Sentinel satellite images


Sentinelsat makes searching, downloading and retrieving the metadata of Sentinel satellite images from the Copernicus Open Access Hub easy.

It offers an easy-to-use command line interface

sentinelsat -u <user> -p <password> -g <search_polygon.geojson> --sentinel 2 --cloud 30

and a powerful Python API.

from sentinelsat import SentinelAPI, read_geojson, geojson_to_wkt

api = SentinelAPI('user', 'password')
footprint = geojson_to_wkt(read_geojson('search_polygon.geojson'))
products = api.query(footprint,

Documentation is published at


Install sentinelsat through pip:

pip install sentinelsat


Sentinelsat provides a Python API and a command line interface to search, download and retrieve the metadata for Sentinel products.

Python Library

from sentinelsat.sentinel import SentinelAPI, read_geojson, geojson_to_wkt
from datetime import date

# connect to the API
api = SentinelAPI('user', 'password', '')

# download single scene by known product id<product_id>)

# search by polygon, time, and Hub query keywords
footprint = geojson_to_wkt(read_geojson('map.geojson'))
products = api.query(footprint,
                     date = ('20151219', date(2015, 12, 29)),
                     platformname = 'Sentinel-2',
                     cloudcoverpercentage = (0, 30))

# download all results from the search

# GeoJSON FeatureCollection containing footprints and metadata of the scenes

# GeoPandas GeoDataFrame with the metadata of the scenes and the footprints as geometries

# Get basic information about the product: its title, file size, MD5 sum, date, footprint and
# its download url

# Get the product's full metadata available on the server
api.get_product_odata(<product_id>, full=True)

Valid search query keywords can be found at the Copernicus Open Access Hub documentation.

Command Line Interface

A basic search query consists of a search area geometry as well as the username and password to access the Copernicus Open Access Hub.

sentinelsat -u <user> -p <password> -g <geojson>

Search areas are provided as GeoJSON files, which can be created with QGIS or If you do not specify a start and end date only products published in the last 24 hours will be queried.


Search and download all Sentinel-1 scenes of type SLC, in descending orbit, for the year 2015.

sentinelsat -u <user> -p <password> --area search_polygon.geojson -s 20150101 -e 20151231 -d \
--producttype SLC -q "orbitdirection=Descending" \
--url ""


-u –user TEXT Username [required]
-p –password TEXT Password [required]
  –url TEXT Define another API URL. Default URL is ‘’.
-s –start TEXT Start date of the query in the format YYYYMMDD.
-e –end TEXT End date of the query in the format YYYYMMDD.
-g –geometry PATH Search area geometry as GeoJSON file.
  –uuid TEXT Select a specific product UUID instead of a query. Multiple UUIDs can separated by commas.
  –name TEXT Select specific product(s) by filename. Supports wildcards.
  –sentinel   Limit search to a Sentinel satellite (constellation).
  –instrument   Limit search to a specific instrument on a Sentinel satellite.
  –producttype   Limit search to a Sentinel product type.
-c –cloud INT Maximum cloud cover in percent. (requires –sentinel to be 2 or 3)
-o –order-by TEXT Comma-separated list of keywords to order the result by. Prefix ‘-‘ for descending order.
-l –limit INT Maximum number of results to return. Defaults to no limit.
-d –download   Download all results of the query.
  –path PATH Set the path where the files will be saved.
-q –query TEXT Extra search keywords you want to use in the query. Separate keywords with comma. Example: ‘producttype=GRD,polarisationmode=HH’.
-f –footprints   Create geojson file search_footprints.geojson with footprints of the query result.
  –version   Show version number and exit.
  –help   Show help message and exit.


To run the tests on sentinelsat:

git clone
cd sentinelsat
pip install -e .[test]
py.test -v

By default, prerecorded responses to Copernicus Open Access Hub queries are used to not be affected by its downtime. To allow the tests to run actual queries against the Copernicus Open Access Hub set the environment variables

export SENTINEL_USER=<username>
export SENTINEL_PASSWORD=<password>

and add --vcr disable to py.test arguments. To update the recordings use either --vcr record_new or --vcr reset.


To build the documentation:

git clone
cd sentinelsat
pip install -e .[docs]
cd docs
make html

The full documentation is also published at


See CHANGELOG. You can also use Githubs compare view to see the changes since last release.


  • Wille Marcel
  • Kersten Clauss
  • Martin Valgur
  • Jonas Sølvsteen
  • Luca Delucchi
  • Gaston Keller

We invite anyone to participate by contributing code, reporting bugs, fixing bugs, writing documentation and tutorials and discussing the future of this project. Please check CONTRIBUTE.rst.



File Type Py Version Uploaded on Size
sentinelsat-0.12.1-py2.py3-none-any.whl (md5) Python Wheel py2.py3 2017-10-24 23KB
sentinelsat-0.12.1.tar.gz (md5) Source 2017-10-24 2MB