Satellite Imagery
Access Restriction
This API is a premium service available only to enterprise tier developers. Please contact Caiyun Sales to purchase.
Returns satellite imagery for the requested time range based on coordinates, product, and resolution.
Request
http
GET https://api.caiyunapp.com/v1/satelliteQuery Parameters
| Name | Required | Default | Range | Description |
|---|---|---|---|---|
token | Yes | — | — | API authentication credential; see Authentication |
show_time | No | 2 | 1~30 | Time range to retrieve, in hours |
lon | No | Default China longitude | — | Target longitude |
lat | No | Default China latitude | — | Target latitude |
product | No | true_color | true_color/C11/ir108_3d | Satellite product; supported values by region are listed below |
resolution | No | 4000M | 2000M/4000M/8000M | Image resolution; supported values by region are listed below |
product
| Region | Value | Description |
|---|---|---|
| China | true_color | True-color imagery |
| China | C11 | Water-vapor imagery |
| China | ir108_3d | 3D cloud imagery |
| North America | true_color | True-color imagery |
resolution
| Region | Value | Description |
|---|---|---|
| China | 4000M | 4 km resolution |
| China | 8000M | 8 km resolution |
| North America | 2000M | 2 km resolution |
| North America | 4000M | 4 km resolution |
Request Example
bash
curl "https://api.caiyunapp.com/v1/satellite?token={token}&show_time=2&lon=116.3176&lat=39.9760&product=true_color&resolution=4000M"Response Example
json
{
"status": "ok",
"images": [
[
"http://meteorology.caiyuncdn.com/satellite/prod/fy4b/preprocess/2025/06/23/true_color/4000M/china_DISK_202506230645_202506230659_webmerc.jpg?source=&auth_key=***",
1750661100,
[6, 66, 54, 136]
],
[
"http://meteorology.caiyuncdn.com/satellite/prod/fy4b/preprocess/2025/06/23/true_color/4000M/china_DISK_202506230715_202506230729_webmerc.jpg?source=&auth_key=***",
1750662900,
[6, 66, 54, 136]
]
]
}Response Fields
| JSONPath | Type | Description |
|---|---|---|
$.status | string | Request status; ok indicates success |
$.images | array<array> | Satellite imagery list |
$.images[][0] | string | Image URL |
$.images[][1] | number | Image timestamp |
$.images[][2] | array<number> | Image bounds using WGS84 coordinates in [south latitude, west longitude, north latitude, east longitude] order |