ASTRA OS
FeaturesUse CasesPricingDocsBlog

Documentation

Getting StartedAuthenticationUnified SearchScene DetailsAsset ResolverProcessingData SourcesSDKs
Getting StartedAuthenticationUnified SearchScene DetailsAsset ResolverProcessingData SourcesSDKs
Getting Started

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.

1

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:

API Key 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.

2

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

terminal
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

search.py
import requests
response = 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;context']['matched']} scenes")
for feature in data["features"]:
print(f" {feature[&"color: #6b7280">#39;id']} — {feature['properties']['datetime']}")

JavaScript

search.js
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}`);
});
3

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.

response.json
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": 5
35 },
36 "warnings": []
37}

Key Response Fields

FieldDescription
features[]Array of STAC Items, one per matched satellite scene
features[].idProvider-scoped ID in the format provider:original_id
features[].propertiesMetadata including datetime, cloud cover, GSD, and ASTRA provider info
features[].assetsDirect download URLs for individual bands and composites
contextPagination info: total matched, returned count, and limit
warningsArray of non-fatal issues (e.g., a provider timeout)
4

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

ASTRA OS

The Operating System for Earth Observation Data.

Product

  • Features
  • Pricing
  • Use Cases
  • Changelog

Developers

  • Documentation
  • API Reference
  • SDKs
  • Status

Company

  • About
  • Blog
  • Careers
  • Contact

Legal

  • Privacy
  • Terms
  • Security

© 2026 ASTRA OS. All rights reserved.