Jump to endpoint

    API Reference

    Complete documentation for all Satalyse satellite intelligence APIs. All endpoints require authentication via Bearer token.

    Authentication

    All API requests require an API key in the Authorization header:

    Authorization: Bearer sat_sk_live_YOUR_API_KEY
    POST/api/v1/satellite/detect-changes

    Change Detection

    Detect if something changed at a location between two dates. Perfect for verifying property damage claims, detecting construction/demolition, and monitoring disaster impact.

    $0.50 per callFree: 50 free calls

    Use Cases

    • Verify property damage claims (InsurTech)
    • Detect construction/demolition (Real Estate)
    • Monitor disaster impact (Government)
    • Track land use changes (ESG)

    Parameters

    geometryRequired

    GeoJSON Polygon

    Area to analyze as GeoJSON Polygon

    start_dateRequired

    string (YYYY-MM-DD)

    Start date for comparison

    end_dateRequired

    string (YYYY-MM-DD)

    End date for comparison

    data_sourceOptional

    string

    Satellite source: 'Sentinel-2' or 'Landsat-8'Default: Sentinel-2

    sensitivityOptional

    string

    'low', 'medium', or 'high'Default: high

    {
  "geometry": {
    "type": "Polygon",
    "coordinates": [[[77.5, 12.9], [77.6, 12.9], [77.6, 13.0], [77.5, 13.0], [77.5, 12.9]]]
  },
  "start_date": "2024-01-01",
  "end_date": "2025-01-01",
  "data_source": "Sentinel-2",
  "sensitivity": "high"
}
    POST/api/v1/satellite/extract-features

    Feature Extraction

    Extract environmental metrics from a location including vegetation index, temperature, water presence, and elevation.

    $0.20 per callFree: 50 free calls

    Use Cases

    • Monitor crop health (AgriTech)
    • Assess vegetation quality (Real Estate, ESG)
    • Check water availability (Government)
    • Evaluate property conditions (Insurance)

    Parameters

    geometryRequired

    GeoJSON Polygon

    Area to analyze

    measurement_dateRequired

    string (YYYY-MM-DD)

    Date for analysis

    features_requestedRequired

    array of strings

    Features to extract: 'vegetation', 'water', 'temperature', 'elevation'

    data_sourceOptional

    string

    'Sentinel-2', 'Landsat-8', or 'MODIS'Default: Sentinel-2

    include_historicalOptional

    boolean

    Include historical trend dataDefault: false

    {
  "geometry": {
    "type": "Polygon",
    "coordinates": [[[77.5, 12.9], [77.6, 12.9], [77.6, 13.0], [77.5, 13.0], [77.5, 12.9]]]
  },
  "measurement_date": "2025-01-15",
  "features_requested": ["vegetation", "water", "temperature"]
}
    POST/api/v1/satellite/detect-anomalies

    Anomaly Detection

    Detect unusual patterns including fires, heat stress, unusual vegetation changes, and pest outbreaks.

    $1.00 per callFree: 50 free calls

    Use Cases

    • Early warning for crop diseases (AgriTech)
    • Detect forest fires (Government, NGOs)
    • Monitor heat stress (Climate, Agriculture)
    • Identify pest outbreaks (AgriTech)

    Parameters

    geometryRequired

    GeoJSON Polygon

    Area to analyze

    baseline_period_startRequired

    string (YYYY-MM-DD)

    Start of the baseline comparison period

    baseline_period_endRequired

    string (YYYY-MM-DD)

    End of the baseline comparison period

    current_period_startRequired

    string (YYYY-MM-DD)

    Start of the current analysis period

    current_period_endRequired

    string (YYYY-MM-DD)

    End of the current analysis period

    anomaly_typesRequired

    array of strings

    'vegetation_stress', 'development'

    anomaly_sensitivityOptional

    string

    'low', 'medium', or 'high'Default: medium

    {
  "geometry": {
    "type": "Polygon",
    "coordinates": [[[77.5, 12.9], [77.6, 12.9], [77.6, 13.0], [77.5, 13.0], [77.5, 12.9]]]
  },
  "baseline_period_start": "2023-01-01",
  "baseline_period_end": "2024-01-01",
  "current_period_start": "2024-06-01",
  "current_period_end": "2025-01-15",
  "anomaly_types": ["vegetation_stress", "development"],
  "anomaly_sensitivity": "medium"
}
    POST/api/v1/satellite/score-risk

    Risk Scoring

    Comprehensive risk assessment for floods, wildfires, droughts, and environmental hazards.

    $1.50 per callFree: 50 free calls

    Use Cases

    • Property risk assessment (Real Estate)
    • Insurance underwriting (InsurTech)
    • ESG risk scoring (Investment firms)
    • Government monitoring (Disaster response)

    Parameters

    geometryRequired

    GeoJSON Polygon

    Area to analyze

    asset_typeRequired

    string

    'commercial_property', 'residential', 'agricultural', or 'industrial'

    location_contextRequired

    string

    'urban', 'suburban', or 'rural'

    risk_factorsRequired

    array of strings

    'flood', 'wildfire', 'drought', 'deforestation'

    time_horizon_daysRequired

    integer

    Risk assessment time horizon in days (1–365)

    {
  "geometry": {
    "type": "Polygon",
    "coordinates": [[[77.5, 12.9], [77.6, 12.9], [77.6, 13.0], [77.5, 13.0], [77.5, 12.9]]]
  },
  "asset_type": "residential",
  "location_context": "suburban",
  "risk_factors": ["flood", "wildfire", "drought"],
  "time_horizon_days": 365
}