{"id":13733997,"url":"https://github.com/jonas-eberle/esa_sentinel","last_synced_at":"2026-01-14T11:01:19.154Z","repository":{"id":88417050,"uuid":"47712138","full_name":"jonas-eberle/esa_sentinel","owner":"jonas-eberle","description":"ESA Sentinel Search \u0026 Download API","archived":true,"fork":false,"pushed_at":"2022-06-06T16:17:03.000Z","size":55,"stargazers_count":51,"open_issues_count":2,"forks_count":18,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-05-29T10:12:32.484Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jonas-eberle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2015-12-09T18:57:35.000Z","updated_at":"2025-03-04T12:39:53.000Z","dependencies_parsed_at":"2024-01-06T09:54:36.876Z","dependency_job_id":"13e8d957-096c-4c36-b1c0-867d47deffb4","html_url":"https://github.com/jonas-eberle/esa_sentinel","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/jonas-eberle/esa_sentinel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonas-eberle%2Fesa_sentinel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonas-eberle%2Fesa_sentinel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonas-eberle%2Fesa_sentinel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonas-eberle%2Fesa_sentinel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jonas-eberle","download_url":"https://codeload.github.com/jonas-eberle/esa_sentinel/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonas-eberle%2Fesa_sentinel/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28417814,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T10:47:48.104Z","status":"ssl_error","status_checked_at":"2026-01-14T10:46:19.031Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T03:00:51.595Z","updated_at":"2026-01-14T11:01:19.135Z","avatar_url":"https://github.com/jonas-eberle.png","language":"Python","funding_links":[],"categories":["`Python` processing of optical imagery (non deep learning)"],"sub_categories":["Download"],"readme":"ESA Sentinel Search \u0026 Download API\n=====\n\nWith this API you can easily search and download scenes from the ESA Copernicus program using the ESA Sentinels Scientific Data Hub. It has been developed for data acquisition at Friedrich-Schiller-University Jena, Department for Earth Observation (www.eo.uni-jena.de) and is part of the EU-H2020 Satellite-based Wetland Observation Service (SWOS) project (www.swos-service.eu). \n\nInstallation\n-----------\n*Needed Python libraries:*\n* GDAL\n* Shapely\n* requests\n* progressbar\n\nOn Windows, using PIP you can install GDAL and Shapely with the whl packages from Gohlke:\nhttp://www.lfd.uci.edu/~gohlke/pythonlibs/\n\nThe API has been tested with Python2.7 under Unix and Windows 7.\n\nUsage of API in Python\n-----------\nPlease see example_s1.py, example_s1_setgeom.py, and example_s2.py with three examples. \n\nTo load features/geometries you can use either the \"load_sites\" method given a geospatial file or the \"set_geometries\" method to directly set a geometry in the Well-known-Text (Wkt) format. \n \nPlease note: Using the \"set_geometries\" method the projection has to be in Lat/Long, EPSG:4326. \n\nThe \"search\" method can be used with further parameters according to the OpenSearch protocol from the ESA Data Hub (see \"productType\" and \"sensoroperationalmode\" as an example below): \nhttps://scihub.copernicus.eu/twiki/do/view/SciHubUserGuide/3FullTextSearch#Search_Keywords\n\nExample:\n\n```Python\nimport sentinel_api as api\n\n# use username and password for ESA DATA Hub authentication\nusername = '****YOUR_ESA_DATA_HUB_USERNAME****'\npassword = '****YOUR_ESA_DATA_HUB_PASSWORD****'\n\n# please also specify the Hub URL:\n# All Sentinel-1 and -2 scenes beginning from 15th Nov. 2015: https://scihub.copernicus.eu/apihub/\n# All historic Sentinel-1 scenes: https://scihub.copernicus.eu/dhus/\ns1 = api.SentinelDownloader(username, password, api_url='https://scihub.copernicus.eu/apihub/')\n\n# set directory for\n# - filter scenes list with existing files\n# - set directory path for data download\ns1.set_download_dir('./')\n\n# load geometries from shapefile\ns1.load_sites('wetlands_v8.shp')\n\n# search for scenes with some restrictions (e.g., minimum overlap 1%)\ns1.search('S1A*', min_overlap=0.01, start_date='2015-12-01', date_type='beginPosition', productType='GRD', sensoroperationalmode='IW')\n\n# add another search query (e.g., for Sentinel-1B); both search results will be merged\ns1.search('S1B*', min_overlap=0.01, start_date='2015-12-01', date_type='beginPosition', productType='GRD', sensoroperationalmode='IW')\n\n# you can either write results to a bash file for wget or download files directly in this script\n# s1.write_results('wget', 'sentinel_api_s1_download.sh')\ns1.download_all()\n```\n\nHelp\n-----------\nFor now, please see the docstrings for each method within the code or within python\n\n```Python\nimport sentinel_api as api\nhelp(api)\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonas-eberle%2Fesa_sentinel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonas-eberle%2Fesa_sentinel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonas-eberle%2Fesa_sentinel/lists"}