Item Previews

last updated: December 06, 2023


The Data API provides previews of Planet imagery data as thumbnails. A thumbnail is a down-sampled PNG version of an item's visual asset that can be used as a preview of the image without needing to download a full GeoTIFF. The thumbnail URL is advertised by the key thumbnail in the _links dictionary of an item's metadata. To see an example, inspect the response of

"_links": {
  "_self": "",
  "assets": ""
  "thumbnail": ""


The thumbnail by default is 256×256 pixels, and can be scaled up to 512×512 by passing in the width parameter and setting it to values up to 512. If you have download access to the visual asset, you can scale the thumbnail higher by setting the width parameter to a maximum of 2048.


Authentication for thumbnails can be done with basic HTTP or by providing an api_key parameter to the URL.

Rate this guide: