Skip to main content

API Overview

Explore the full range of available API endpoints to manage and retrieve multi-spectral, cloudless imagery. For sample code and detailed usage examples of key endpoints (such as acquiring images with our Composite API), check out our GitHub page.

1. API Access and Authentication​

To interact with the ClearSKY API, you’ll need an API key, which serves as your authentication credential. Follow these steps to get started:

  • Obtain an API Key:
    Sign up on [order.clearsky.vision] to receive an trial API key to explore our services before committing. You can use the API Key Info endpoint to view details related to your API key, including usage limits and expiration dates.

  • Authenticate Your Requests:
    All API calls require your API key to be passed in the request header for authentication.

  • Paid API Endpoints:

    • The Create Tasking Order endpoint (/api/tasking/orders) uses EUR credits.
    • The Composite API endpoint (/api/satelliteimages/process/composite) uses ‘km²’ credits.

2. Core Functionality and Key Endpoints​

ClearSKY API offers a range of endpoints that allow you to manage and retrieve cloudless imagery. Two of the most important endpoints are:

  • Tasking API:
    Use this endpoint to order cloudless imagery for a specific Area of Interest (AOI). Define the geographical area using bounding boxes, and our system will schedule the acquisition and prediction of data. This is necessary for ordering images for past, present, or future dates.

  • Composite API:
    Once your data is ready, retrieve the ordered imagery using custom polygons or bounding boxes. This endpoint allows you to download imagery and manipulate its geometry as per your project’s needs.

Each endpoint is designed to offer flexibility and customization based on your data requirements. Please refer to the API documentation for a full list of endpoints.

3. Additional API Endpoints​

  • API Key Info:
    Retrieve details related to your API key, including usage limits and expiration dates.

  • Comparison Request:
    Compare our cloudless imagery against original Sentinel-2 data across different dates or AOIs.

  • Acquisition Plans:
    Access data acquisition schedules for our utilized input data (e.g., expected Sentinel-2 orbits).