ASTRA OS Documentation
ASTRA OS is a unified API for satellite earth observation data. Search, access, and process imagery from Sentinel-2, Landsat, and Planetary Computer through a single REST endpoint. All responses follow the STAC specification and imagery is delivered as Cloud-Optimized GeoTIFFs.
Quick Overview
Unified Search
Query Sentinel-2, Landsat 8/9, and Planetary Computer in a single API call.
Scene Details
Retrieve complete STAC metadata for any scene by its provider-scoped ID.
Asset Resolver
Get download URLs for specific bands and formats, with automatic COG routing.
Processing
Run NDVI, change detection, and other analytics on imagery via async jobs.
Sign Up and Get an API Key
Create an account at astraos.cloud/dashboard and navigate to the API Keys section. Click Create Key to generate your first key. All keys follow the format:
astra_sk_live_abc123def456...Your key starts with astra_ and grants access to all API endpoints. Keep it secret. See the Authentication page for rate limits and key management details.
Make Your First Search Request
The search endpoint queries all connected satellite data sources at once. Pass a bounding box and date range to find available scenes.
cURL
curl "https:"color: #6b7280">//astraos.cloud/api/v1/search?\ bbox=-122.5,37.5,-122.0,38.0&\ datetime=2025-01-01/2025-02-01&\ cloud_cover_lt=20&\ limit=5" \ -H "Authorization: Bearer astra_sk_live_your_key_here"Python
import requestsresponse = requests.get( "https://astraos.cloud/api/v1/search", params={ "bbox": "-122.5,37.5,-122.0,38.0", "datetime": "2025-01-01/2025-02-01", "cloud_cover_lt": 20, "limit": 5, }, headers={ "Authorization": "Bearer astra_sk_live_your_key_here" },)data = response.json()print(f"Found {data[&"color: #6b7280">#39;context39;][39;matched39;]} scenes")for feature in data["features"]: print(f" {feature[&"color: #6b7280">#39;id39;]} — {feature[39;properties39;][39;datetime39;]}")JavaScript
const params = new URLSearchParams({ bbox: "-122.5,37.5,-122.0,38.0", datetime: "2025-01-01/2025-02-01", cloud_cover_lt: "20", limit: "5",});const response = await fetch( `https:"color: #6b7280">//astraos.cloud/api/v1/search?${params}`, { headers: { Authorization: "Bearer astra_sk_live_your_key_here", }, });const data = await response.json();console.log(`Found ${data.context.matched} scenes`);data.features.forEach((f) => { console.log(` ${f.id} — ${f.properties.datetime}`);});Understand the Response
All search results are returned as a STAC-compliant FeatureCollection. Each feature represents a satellite scene with full metadata, geometry, and asset links.
1{2 "type": "FeatureCollection",3 "features": [4 {5 "type": "Feature",6 "stac_version": "1.0.0",7 "id": "sentinel-2:S2B_MSIL2A_20250115T184929",8 "geometry": {9 "type": "Polygon",10 "coordinates": [[[-122.5,37.5],[-122.0,37.5],[-122.0,38.0],[-122.5,38.0],[-122.5,37.5]]]11 },12 "properties": {13 "datetime": "2025-01-15T18:49:29Z",14 "eo:cloud_cover": 12.4,15 "platform": "sentinel-2b",16 "constellation": "sentinel-2",17 "gsd": 10,18 "astra:provider": "copernicus",19 "astra:collection": "sentinel-2-l2a"20 },21 "assets": {22 "B04": { "href": "https://...", "type": "image/tiff; application=geotiff; profile=cloud-optimized" },23 "B08": { "href": "https://...", "type": "image/tiff; application=geotiff; profile=cloud-optimized" },24 "visual": { "href": "https://...", "type": "image/tiff; application=geotiff; profile=cloud-optimized" }25 },26 "links": [27 { "rel": "self", "href": "https://astraos.cloud/api/v1/scenes/sentinel-2:S2B_MSIL2A_20250115T184929" }28 ]29 }30 ],31 "context": {32 "matched": 23,33 "returned": 5,34 "limit": 535 },36 "warnings": []37}Key Response Fields
| Field | Description |
|---|---|
| features[] | Array of STAC Items, one per matched satellite scene |
| features[].id | Provider-scoped ID in the format provider:original_id |
| features[].properties | Metadata including datetime, cloud cover, GSD, and ASTRA provider info |
| features[].assets | Direct download URLs for individual bands and composites |
| context | Pagination info: total matched, returned count, and limit |
| warnings | Array of non-fatal issues (e.g., a provider timeout) |
Next Steps
You have the basics down. Explore the rest of the API to build your integration.
Authentication
API key formats, rate limits, and key management
Unified Search
Full reference for query parameters and response format
Scene Details
Fetch complete metadata for a specific scene
Asset Resolver
Download individual bands in COG format with band selection
Processing
NDVI computation, change detection, and async job management
Data Sources
Supported satellites, resolutions, and collection IDs