Data API Reference
Planet Data API (1.0.0)
Download OpenAPI specification:Download
The Planet Data API serves all Planet Labs imagery to public clients. This is the general spec that governs the common API objects and operations.
List Asset Types
List all asset types available to the authenticated user.
An asset
describes a product that can be derived from an item's source data, and can be used for various analytic, visual or other purposes. These are referred to as asset_types
.
Authorizations:
Responses
Response samples
- 200
{- "_links": {
- "_self": "string"
}, - "asset_types": [
- {
- "_links": {
- "_self": "string"
}, - "display_description": "string",
- "display_name": "string",
- "id": "string",
- "md5_digest": "string"
}
]
}
Get Asset Type
Get an asset type by id.
An asset
describes a product that can be derived from an item's source data, and can be used for various analytic, visual or other purposes. These are referred to as asset_types
.
Authorizations:
path Parameters
asset_type_id required | string Asset type identifier. |
Responses
Response samples
- 200
- 404
{- "_links": {
- "_self": "string"
}, - "display_description": "string",
- "display_name": "string",
- "id": "string",
- "md5_digest": "string"
}
List Item Types
List all item types available to the authenticated user.
An item_type
represents the class of spacecraft and/or processing level of an item. All items have an associated item_type
. Each item_type
has a set of supported asset_types
which may be produced for a given item.
Authorizations:
Responses
Response samples
- 200
{- "_links": {
- "_self": "string"
}, - "item_types": [
- {
- "_links": {
- "_self": "string"
}, - "display_description": "string",
- "display_name": "string",
- "id": "string",
- "supported_asset_types": [
- "analytic"
]
}
]
}
Get Item Type
Get an item type by id.
An item_type
represents the class of spacecraft and/or processing level of an item. All items have an associated item_type
. Each item_type
has a set of supported asset_types
which may be produced for a given item.
Authorizations:
path Parameters
item_type_id required | string Item type identifier. |
Responses
Response samples
- 200
- 404
{- "_links": {
- "_self": "string"
}, - "display_description": "string",
- "display_name": "string",
- "id": "string",
- "supported_asset_types": [
- "analytic"
]
}
Get Item
Get an item by id and item type.
In the Planet API, an item
is an entry in our catalog, and generally represents a single logical observation (or scene) captured by a satellite. Each item
is defined by an item_type
, which represents the class of spacecraft and/or processing level of the item. Assets (or products, such as visual or analytic) can be derived from the item's source data.
Authorizations:
path Parameters
item_type_id required | string Item type identifier. |
item_id required | string Item identifier. |
Responses
Response samples
- 200
- 404
{- "_links": {
- "_self": "string",
- "assets": "string",
- "thumbnail": "string"
}, - "_permissions": null,
- "assets": null,
- "geometry": {
- "relation": "intersects",
- "type": "Polygon"
}, - "id": "string",
- "properties": {
- "acquired": "2019-08-24T14:15:22Z",
- "anomalous_pixels": 0.1,
- "black_fill": 0.1,
- "cloud_cover": 0.1,
- "columns": 0,
- "epsg_code": 0,
- "gsd": 0.1,
- "item_type": "string",
- "origin_x": 0,
- "origin_y": 0,
- "pixel_resolution": 0,
- "provider": "string",
- "published": "2019-08-24T14:15:22Z",
- "rows": 0,
- "satellite_id": "string",
- "sun_azimuth": 0.1,
- "sun_elevation": 0.1,
- "updated": "2019-08-24T14:15:22Z",
- "usable_data": 0.1,
- "view_angle": 0.1
}
}
List Item Assets
List all assets available for an item.
An asset
describes a product that can be derived from an item's source data, and can be used for various analytic, visual or other purposes. These are referred to as asset_types
.
Authorizations:
path Parameters
item_type_id required | string Item type identifier. |
item_id required | string Item identifier. |
Responses
Response samples
- 200
- 404
{- "_links": {
- "_self": "string",
- "activate": "string",
- "type": "string"
}, - "_permissions": [
- "download"
], - "expires_at": "2019-08-24T14:15:22Z",
- "location": "string",
- "status": "inactive",
- "type": "string"
}
cloud coverage estimate
gets coverage estimate
Authorizations:
path Parameters
item_type_id required | string Item type identifier. |
item_id required | string Item identifier. |
query Parameters
mode | string Enum: "UDM2" "estimate" The mode to calculate coverage. - |
band | string Enum: "clear" "snow_ice" "cloud_shadow" "light_haze" "heavy_haze" "cloud" "cirrus" The UDM2 band used to calculate coverage. |
Request Body schema: application/jsonrequired
The area of the cloud coverage request.
Responses
Request samples
- Payload
Response samples
- 201
- 404
{- "clear_percent": 0,
- "status": "string"
}
Quick Search
Executes a structured item search.
The search APIs allow for both simple and complex item
searches. Complex searches support boolean conditions, multiple values, geometries using GeoJSON and others. You can also save, retrieve and execute searches that you use frequently for easy use later.
Authorizations:
query Parameters
_page_size | integer <int64> [ 0 .. 250 ] Default: 250 Number of results to return per page. This may only be used at the start of pagination. This may not be provided with the "_page" parameter. |
_sort | string Default: "published desc" Enum: "acquired asc" "acquired desc" "published asc" "published desc" Field and direction to order results by. This may not be provided with the "_page" parameter. |
Request Body schema: application/jsonrequired
The structured search criteria.
asset_types | Array of strings The asset types to include in the search. |
object (Filter) Structured search criteria. | |
object (GeoJSONGeometry) A GeoJSON geometry. | |
item_types required | Array of strings The item types to include in the search. |
name | string^.{1,64}$ The name of the saved search. |
Responses
Request samples
- Payload
{- "asset_types": [
- "string"
], - "filter": {
- "type": "string"
}, - "geometry": {
- "relation": "intersects",
- "type": "Polygon"
}, - "item_types": [
- "string"
], - "name": "string"
}
Response samples
- 200
- 400
{- "_links": {
- "_self": "string",
- "_first": "string",
- "_next": "string"
}, - "features": [
- {
- "_links": {
- "_self": "string",
- "assets": "string",
- "thumbnail": "string"
}, - "_permissions": null,
- "assets": null,
- "geometry": {
- "relation": "intersects",
- "type": "Polygon"
}, - "id": "string",
- "properties": {
- "acquired": "2019-08-24T14:15:22Z",
- "anomalous_pixels": 0.1,
- "black_fill": 0.1,
- "cloud_cover": 0.1,
- "columns": 0,
- "epsg_code": 0,
- "gsd": 0.1,
- "item_type": "string",
- "origin_x": 0,
- "origin_y": 0,
- "pixel_resolution": 0,
- "provider": "string",
- "published": "2019-08-24T14:15:22Z",
- "rows": 0,
- "satellite_id": "string",
- "sun_azimuth": 0.1,
- "sun_elevation": 0.1,
- "updated": "2019-08-24T14:15:22Z",
- "usable_data": 0.1,
- "view_angle": 0.1
}
}
]
}
List Saved Searches
List all saved searches available to the authenticated user.
Authorizations:
query Parameters
_page | string Token representing a specific page of results. This should never be constructed manually. |
_page_size | integer <int64> [ 0 .. 250 ] Default: 250 Number of results to return per page. This may only be used at the start of pagination. This may not be provided with the "_page" parameter. |
_sort | string Default: "created desc" Enum: "created desc" "created asc" Field and direction to order results by. This may not be provided with the "_page" parameter. |
search_type | string Default: "any" Enum: "any" "saved" "quick" Search type filter. |
Responses
Response samples
- 200
{- "_links": {
- "_self": "string",
- "_first": "string",
- "_next": "string",
- "_prev": "string"
}, - "searches": [
- {
- "__daily_email_enabled": false,
- "_links": {
- "_self": "string",
- "thumbnail": "string"
}, - "created": "2019-08-24T14:15:22Z",
- "filter": {
- "type": "string"
}, - "id": "string",
- "last_executed": "2019-08-24T14:15:22Z",
- "name": "string",
- "updated": "2019-08-24T14:15:22Z"
}
]
}
Create Saved Search
Create a new saved search.
Authorizations:
Request Body schema: application/jsonrequired
The structured search criteria.
__daily_email_enabled | boolean Send a daily email when new results are added. |
asset_types | Array of strings The asset types to include in the search. |
required | object (Filter) Structured search criteria. |
item_types required | Array of strings The item types to include in the search. |
name required | string^.{1,64}$ The name of this saved search. |
Responses
Request samples
- Payload
{- "__daily_email_enabled": true,
- "asset_types": [
- "string"
], - "filter": {
- "type": "string"
}, - "item_types": [
- "string"
], - "name": "string"
}
Response samples
- 200
- 400
{- "__daily_email_enabled": false,
- "_links": {
- "_self": "string",
- "thumbnail": "string"
}, - "created": "2019-08-24T14:15:22Z",
- "filter": {
- "type": "string"
}, - "id": "string",
- "last_executed": "2019-08-24T14:15:22Z",
- "name": "string",
- "updated": "2019-08-24T14:15:22Z"
}
Delete Saved Search
Delete an existing saved search.
Authorizations:
path Parameters
search_id required | string Saved search identifier. |
Responses
Response samples
- 404
{- "field": {
- "property1": [
- {
- "message": "string"
}
], - "property2": [
- {
- "message": "string"
}
]
}, - "general": [
- {
- "message": "string"
}
]
}
Get Saved Search
Get a saved search by id.
Authorizations:
path Parameters
search_id required | string Saved search identifier. |
Responses
Response samples
- 200
- 404
{- "__daily_email_enabled": false,
- "_links": {
- "_self": "string",
- "thumbnail": "string"
}, - "created": "2019-08-24T14:15:22Z",
- "filter": {
- "type": "string"
}, - "id": "string",
- "last_executed": "2019-08-24T14:15:22Z",
- "name": "string",
- "updated": "2019-08-24T14:15:22Z"
}
Update Saved Search
Update an existing saved search.
Authorizations:
path Parameters
search_id required | string Saved search identifier. |
Request Body schema: application/jsonrequired
The structured search criteria.
__daily_email_enabled | boolean Send a daily email when new results are added. |
asset_types | Array of strings The asset types to include in the search. |
required | object (Filter) Structured search criteria. |
item_types required | Array of strings The item types to include in the search. |
name required | string^.{1,64}$ The name of this saved search. |
Responses
Request samples
- Payload
{- "__daily_email_enabled": true,
- "asset_types": [
- "string"
], - "filter": {
- "type": "string"
}, - "item_types": [
- "string"
], - "name": "string"
}
Response samples
- 200
- 400
{- "__daily_email_enabled": false,
- "_links": {
- "_self": "string",
- "thumbnail": "string"
}, - "created": "2019-08-24T14:15:22Z",
- "filter": {
- "type": "string"
}, - "id": "string",
- "last_executed": "2019-08-24T14:15:22Z",
- "name": "string",
- "updated": "2019-08-24T14:15:22Z"
}
Run Saved Search
Executes a saved search.
Authorizations:
path Parameters
search_id required | string Saved search identifier. |
query Parameters
_page | string Token representing a specific page of results. This should never be constructed manually. |
_page_size | integer <int64> [ 0 .. 250 ] Default: 250 Number of results to return per page. This may only be used at the start of pagination. This may not be provided with the "_page" parameter. |
_sort | string Default: "published desc" Enum: "acquired asc" "acquired desc" "published asc" "published desc" Field and direction to order results by. This may not be provided with the "_page" parameter. |
Responses
Response samples
- 200
- 404
{- "_links": {
- "_self": "string",
- "_first": "string",
- "_next": "string"
}, - "features": [
- {
- "_links": {
- "_self": "string",
- "assets": "string",
- "thumbnail": "string"
}, - "_permissions": null,
- "assets": null,
- "geometry": {
- "relation": "intersects",
- "type": "Polygon"
}, - "id": "string",
- "properties": {
- "acquired": "2019-08-24T14:15:22Z",
- "anomalous_pixels": 0.1,
- "black_fill": 0.1,
- "cloud_cover": 0.1,
- "columns": 0,
- "epsg_code": 0,
- "gsd": 0.1,
- "item_type": "string",
- "origin_x": 0,
- "origin_y": 0,
- "pixel_resolution": 0,
- "provider": "string",
- "published": "2019-08-24T14:15:22Z",
- "rows": 0,
- "satellite_id": "string",
- "sun_azimuth": 0.1,
- "sun_elevation": 0.1,
- "updated": "2019-08-24T14:15:22Z",
- "usable_data": 0.1,
- "view_angle": 0.1
}
}
]
}
Search Stats
Returns a date bucketed histogram of items matching a filter
Authorizations:
Request Body schema: application/jsonrequired
The structured search criteria.
asset_types | Array of strings The asset types to include in the stats. |
required | object (Filter) Structured search criteria. |
interval required | string Enum: "hour" "day" "week" "month" "year" The size of the histogram date buckets. |
item_types required | Array of strings The item types to include in the stats. |
utc_offset | string A "ISO 8601 UTC offset" (e.g. +01:00 or -08:00) that can be used to adjust the buckets to a users time zone. It is optional. |
Responses
Request samples
- Payload
{- "asset_types": [
- "string"
], - "filter": {
- "type": "string"
}, - "interval": "hour",
- "item_types": [
- "string"
], - "utc_offset": "string"
}
Response samples
- 200
- 400
{- "buckets": [
- {
- "count": 0,
- "start_time": "2019-08-24T14:15:22Z"
}
], - "interval": "hour",
- "utc_offset": "string"
}