sentinel-hub.com APIsentinel-hub.com ↗
Access Sentinel-1 and Sentinel-2 collection metadata, search imagery by bounding box and date, and compute band statistics via the Sentinel Hub STAC API.
No input parameters required.
curl -X POST 'https://api.parse.bot/scraper/c10683f6-4dad-49e8-b0e7-23417b97a14d/catalog_search' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"bbox": "[13.0, 45.0, 14.0, 46.0]",
"limit": "5",
"datetime": "2023-01-01T00:00:00Z/2023-01-31T23:59:59Z",
"collections": "[\"sentinel-2-l2a\"]"
}'Search satellite imagery by bounding box, datetime range, and collections. Returns STAC-compliant items. Requires Bearer token in headers or prior authentication.
No input parameters required.
{
"sample": {
"status": "error",
"message": "Unauthorized. Call authenticate first."
}
}About the sentinel-hub.com API
This API exposes 6 endpoints covering the Sentinel Hub STAC catalog, letting you retrieve collection metadata, search imagery scenes, and run band-level statistics over custom areas of interest. The get_collections endpoint returns structured metadata for every available collection — including spatial bounding boxes, temporal intervals, spectral bands, platforms, and data providers. Companion endpoints handle catalog introspection, conformance class discovery, imagery processing, and statistical analysis.
Collection and Catalog Discovery
The get_collections endpoint returns a collections array where each object includes the collection id, title, description, license, spatial_bbox, temporal_interval, platform, instrument, and constellation details. get_catalog_info returns the catalog root — id, type, title, description, stac_version, a conformsTo array of URI strings, and a links array with href, rel, type, and optional title and method fields. get_conformance returns just the conformsTo array, useful when you need to verify which STAC and OGC API conformance classes the server advertises.
Imagery Search and Processing
catalog_search accepts a POST body specifying a bounding box, datetime range, and target collections, returning STAC-compliant item records for matching scenes. This endpoint requires a Bearer token. process_image also takes a POST body and supports custom evalscripts for per-pixel spectral band manipulation over a defined area and time window — useful for computing indices like NDVI or extracting raw reflectance values. Both endpoints require authentication, so you will need a valid token before calling them.
Statistical Analysis
get_statistics computes aggregate band statistics over a defined area of interest (AOI). Like process_image, it uses a POST body and requires authentication. This is the appropriate endpoint when you need summary metrics — mean, min, max, histogram bins — rather than full raster output. The response shape for process_image, get_statistics, and catalog_search is not fixed in the current schema, so callers should handle flexible JSON or binary responses depending on the evalscript and format parameters supplied.
- Querying available Sentinel-2 spectral bands and temporal coverage before building a remote sensing pipeline
- Searching for cloud-free imagery scenes over a specific bounding box and date range using catalog_search
- Verifying STAC and OGC API conformance class support for interoperability with third-party GIS clients via get_conformance
- Computing vegetation index statistics (e.g. NDVI) over agricultural AOIs using get_statistics
- Listing all collection providers and spatial extents to map data availability for a given region
- Integrating STAC catalog metadata into a geospatial data catalog or asset management system
- Automating change detection workflows by querying temporal intervals from collection metadata
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Sentinel Hub have an official developer API?+
What does get_collections return for each collection?+
collections array includes the collection id, title, description, license, spatial_bbox (bounding box coordinates), temporal_interval (start and end dates), platform, instrument, and constellation information. The total field at the top level gives the count of collections returned.Does catalog_search support filtering by cloud cover or resolution?+
Are processed image responses returned as raw raster data or structured JSON?+
process_image is not fixed in the current schema — the format depends on parameters supplied in the POST body, including the evalscript and requested output format. Callers should expect either binary image data or structured JSON depending on configuration. Statistical output from get_statistics returns aggregate band metrics over the specified AOI.