The satelligence API provides 4 capabilities to synchronize data to and from the platform:
A full fledged set of endpoints to manage supply chain data in the platform. Use this endpoint to set up automated data synchronization of supply chain data to the Satelligence platform and fully leverage the risk assessment and mitigation features inside the platform.
An endpoint that can serve to sync plot data from the platform into your own systems. It can serve both plot metadata, geometries, and risk assessments from the platform.
A lightweight endpoint to access geospatial risk information for a given boundary without uploading supply chain data to the platform. Use this endpoint to leverage the Satelligence geospatial data but build your own risk assessment and mitigation strategies outside of the Satelligence platform.
To fetch all deforestation and fire detections in shapefile format. Use this endpoint to gather the raw Satelligence real time data and build your own archive of detections for fully custom workflows.
Authentication requires an API token, contact support@satelligence.com to request one. To authenticate your requests, set the Authorization: Bearer $token header in your requests.
The token is connected to a personal account, it will have the same permissions as the account that created it. If the linked user belongs to multiple projects, the token will default to the 'active project' for that user.
https://docs.satelligence.com/_mock/api/
https://api.satelligence.com/
These endpoints give full control over supply chain data uploads and ingestion.
For a bulk upload, plots must be formatted as a GeoJSON file and uploaded to a secure location in Satelligence's Google Cloud Storage bucket through a signed URL. The complete process consists of three steps:
/bulk-uploads endpoint, which generates signed URLs for each file you want to upload./bulk-uploads/start endpoint.The process can be automated with the scripts linked here.
This endpoint can be useful in many different situations:
It is paginated and returns 200 plots at a time. Use the nextUrl returned in the response to fetch the next page of results.
https://docs.satelligence.com/_mock/api/v1/plots
https://api.satelligence.com/v1/plots
import requests
url = "https://docs.satelligence.com/_mock/api/v1/plots"
query = {
"projectId": "string",
"withGeometry": "true",
"cursor": "string",
"hasSatelliteMonitoring": "true"
}
headers = {"Authorization": "Bearer <YOUR_TOKEN_HERE>"}
response = requests.get(url, headers=headers, params=query)
data = response.json()
print(data){ "plots": [ { … } ], "nextUrl": "string" }