Complete API Reference

Comprehensive documentation for all Ekagni Space APIs including satellite data, climate information, disaster alerts, and analytics platform. Get started quickly with our detailed guides, code examples, and interactive documentation.

4 APIs
100+ Endpoints
Multi-Lang Examples

API Overview

🛰️

Satellite Data API

Access high-resolution satellite imagery, multi-spectral data, and Earth observation information.

Base URL: /v1/satellite
Rate Limit: 1000/hour
View API
🌡️

Climate API

Real-time weather data, climate forecasts, and environmental monitoring information.

Base URL: /v1/climate
Rate Limit: 1000/hour
View API
🚨

Disaster Alert API

Real-time disaster monitoring, early warning systems, and emergency response data.

Base URL: /v1/disaster
Rate Limit: 1000/hour
View API
📊

Analytics Platform

Advanced data analytics, machine learning, and visualization tools for satellite data.

Base URL: /v1/analytics
Rate Limit: 500/hour
View API

Getting Started

1

Get API Key

Sign up for a free account and get your API key to start making requests.

Get API Key
2

Make Your First Request

Use our interactive documentation to make your first API call and see the response.

Try It Now
3

Explore Examples

Browse our code examples in multiple programming languages to get started quickly.

View Examples

API Reference

Authentication

All Ekagni APIs use API key authentication. Include your API key in the Authorization header of every request.

Example Request

curl -X GET "https://api.ekagni.com/v1/satellite/imagery" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Getting Your API Key

  1. Sign up for a free account at Get API
  2. Navigate to your dashboard
  3. Copy your API key from the API Keys section
  4. Include it in the Authorization header of your requests

Rate Limits

Rate limits are applied per API key and vary by plan. Exceeding rate limits will result in HTTP 429 responses.

Plan Requests/Hour Requests/Day Burst Limit
Free 1,000 10,000 100
Professional 50,000 500,000 1,000
Enterprise Unlimited Unlimited 10,000

Error Handling

Ekagni APIs use standard HTTP status codes and return detailed error information in JSON format.

400 - Bad Request

Invalid request parameters or malformed request body.

401 - Unauthorized

Invalid or missing API key.

429 - Too Many Requests

Rate limit exceeded. Check your plan limits.

500 - Internal Server Error

Server error. Please try again later.

Webhooks

Set up webhooks to receive real-time notifications for events like new data availability or processing completion.

Webhook Payload Example

{
  "event": "data.available",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "resource_id": "satellite_imagery_123",
    "resource_type": "satellite_imagery",
    "status": "ready"
  }
}

Code Examples

cURL Examples

Get Satellite Imagery

curl -X GET "https://api.ekagni.com/v1/satellite/imagery" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lat": 37.7749,
    "lon": -122.4194,
    "radius": 10,
    "start_date": "2024-01-01",
    "end_date": "2024-01-31"
  }'

Python Examples

Python SDK

import ekagni

# Initialize client
client = ekagni.Client(api_key="YOUR_API_KEY")

# Get satellite imagery
imagery = client.satellite.get_imagery(
    lat=37.7749,
    lon=-122.4194,
    radius=10,
    start_date="2024-01-01",
    end_date="2024-01-31"
)

print(f"Found {len(imagery)} images")

JavaScript Examples

JavaScript SDK

const Ekagni = require('ekagni');

// Initialize client
const client = new Ekagni('YOUR_API_KEY');

// Get satellite imagery
const imagery = await client.satellite.getImagery({
  lat: 37.7749,
  lon: -122.4194,
  radius: 10,
  startDate: '2024-01-01',
  endDate: '2024-01-31'
});

console.log(`Found ${imagery.length} images`);

PHP Examples

PHP SDK

satellite->getImagery([
    'lat' => 37.7749,
    'lon' => -122.4194,
    'radius' => 10,
    'start_date' => '2024-01-01',
    'end_date' => '2024-01-31'
]);

echo "Found " . count($imagery) . " images";
?>

Ready to Start Building?

Get your API key and start integrating Ekagni's satellite data APIs