Bulk Download API

The Bulk Download API is designed to support workflows that require bulk access to data, including integration with platforms and tools used by data engineers and researchers. At the moment we are releasing with the API dataset of Fixed infrastructure detections derived from Sentinel-1 and Sentinel-2 satellite imagery.

This API allows you to:

• Create bulk reports based on specific filters and spatial parameters
• Monitor report generation status
• Download datasets in CSV or JSON format
• Retrieve region geometry and metadata

Supported Bulk-download API Datasets

Fixed infrastructure detections from Sentinel-1 and Sentinel-2

The API dataset used in this API is: public-fixed-infrastructure-data:latest

Offshore fixed infrastructure is a global dataset detected and classified using Synthetic Aperture Radar (SAR) and Optical imagery from the Sentinel-1 and Sentinel-2 satellite constellations. The dataset is updated daily and includes detections from 2017 to approximately three months before the current date. This dataset supports use cases in maritime domain awareness, vessel monitoring, marine spatial planning, and environmental analysis. Refer to Paolo et al. 2024, Nature: View the paper. This API dataset returns the same data published in our Data Download Portal here.

Detection is performed using a Constant False Alarm Rate (CFAR) algorithm, modified to exclude non-stationary objects. Deep learning (based on the ConvNeXt architecture) is applied to classify detections into the categories: oil, wind, unknown, lake maracaibo, and noise. Post-processing includes clustering, temporal smoothing, and manual expert review. Each detection is assigned a confidence level (high, medium, or low) to support interpretation. For more details on Data Caveats, please visit, Fixed Infrastructure Data Caveats

Difference between this Bulk Download API and the Datasets API regarding fixed infrastructure

This Bulk Download API returns all fixed infrastructure data, including regions like Chile, Canada, and Norway, as well as some noisy data, while the Datasets API and our Map filter out noisy data.

Available Bulk Download API endpoints

1. Create a new Bulk Report – Generate fixed infrastructure reports by specifying spatial filters, dataset, and date range. Supports CSV or JSON formats.
2. Get Bulk Report status by ID – Check the current status of a report (e.g. pending, done, failed) and metadata including creation timestamp.
3. Download report files – Retrieve signed URLs for downloading the data file (DATA), metadata (README), or region geometry (GEOM) used in the report.
4. Query report results in JSON – Access the structured contents of the generated report with pagination and sorting capabilities. Ideal for filtered previews or integration with scripts.
5. Get all Bulk Download reports by User - Use this endpoint to retrieve all bulk reports created by your user or application.