CANOPYSAT

CanopySat Forest Intelligence API

Integrate forest intelligence into your applications — real-time satellite analysis, forest integrity scores, deforestation detection and NASA GEDI canopy height for any zone on Earth.

Plans & Pricing

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Create your free API key via the endpoint below or contact us.

Endpoints

curl -X POST https://www.canopysat.org/api/v1/analyze \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat": -3.4653, "lng": -62.2159, "size": 10}'

{
  "success": true,
  "score": 87,
  "ndvi_current": 0.823,
  "forest_cover": 98.5,
  "canopy_height": 24.3,
  "canopy_height_rh50": 12.1,
  "gedi_cover": 99.2,
  "canopy_height_source": "NASA GEDI LiDAR",
  "ai_forest_type": "Dense Tropical Forest",
  "deforestation_alert": "STABLE",
  "active_fires": 0,
  "sentinel1_vv": -8.234,
  "trend": "improving",
  "satellites_used": ["ESA Sentinel-2", "NASA FIRMS", "ESA Sentinel-1", "NASA Landsat 8/9", "NASA Landsat 4/5", "NASA GEDI LiDAR"]
}

curl -X POST https://www.canopysat.org/api/v1/key/create \
  -H "Content-Type: application/json" \
  -d '{"name": "John Doe", "email": "john@example.com"}'

curl https://www.canopysat.org/api/v1/key/status \
  -H "Authorization: Bearer YOUR_API_KEY"

Satellites Used

Code Examples

Install the official SDK:

pip install canopysat

📦 pypi.org/project/canopysat · github.com/SautiRay/canopysat

Python:

from canopysat import Forest

# Simple — no API key needed (10 free analyses/month)
result = Forest.analyze(lat=-3.4653, lng=-62.2159, size=10)
print(result.score)           # 80
print(result.canopy_height)   # 13.2m (NASA GEDI LiDAR)
print(result.summary())

# With API key
import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://www.canopysat.org/api/v1"

response = requests.post(f"{BASE_URL}/analyze",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"lat": -3.4653, "lng": -62.2159, "size": 10}
)
data = response.json()
print(f"Forest Score: {data['score']}/100")
print(f"Canopy Height: {data['canopy_height']}m (NASA GEDI)")
print(f"Deforestation Alert: {data['deforestation_alert']}")

JavaScript:

const response = await fetch('https://www.canopysat.org/api/v1/analyze', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({lat: -3.4653, lng: -62.2159, size: 10})
});
const data = await response.json();
console.log(`Forest Score: ${data.score}/100`);
console.log(`Canopy Height: ${data.canopy_height}m (NASA GEDI)`);

📞 Get an API Key

Contact us to get your free API key or to upgrade to a higher plan.