Skip to main content

Data Access and Management APIs

Data API, Orders API, Subscriptions API, Basemaps API, Bring Your Own COG API, Zarr Import API, Catalog API, and Features API.

  • 45 Topics
  • 110 Replies
45 Topics
hariseldon
hariseldon‎‎ 🌱
asked in Data Access and Management APIs
503 error for Sentinel Hub and Copernicus

We are experiencing persistent 503 Service Unavailable errors when calling the Sentinel Hub Catalog and Process APIs. The issue has lasted for more than 24 hours, which makes me concerned that this is not a transient load spike. Our setup:  Endpoint: https://services.sentinel-hub.com APIs: Catalog (/api/v1/catalog/search) and Process (/api/v1/process) Authentication: OAuth client credentials (working correctly, token is obtained) Script retries requests with exponential back-off, but 503s continue consistently.   Could you please confirm if there is an ongoing outage or maintenance affecting these APIs? If not, we would appreciate guidance on any configuration or endpoint changes we should make

182
hariseldon
mardim
mardim‎‎ 🌱
asked in Data Access and Management APIs
Sentiel Hub API Deprecated?

Hi, I am trying to understand if Sentiel Hub API is deprecated or not, but get mixed responses online. Also, if it is, what is the alternative? My goal is to get NDVI and do some other calculations of agriculture related parameters.

1481
williamray
Planeteer 🌎
george.begkas
george.begkas‎‎ 🌱
asked in Data Access and Management APIs
Planet Fusion and SentinelHub Catalog API

Hello, I am downloading Planet Fusion data for a project through a BYOC Collection on SentinelHub. The plan is to have a STAC catalog on my side to archive the data for future use. When I query the Catalog API I get STAC items that have an empty object in the assets field. Is this normal? Is there a way to get this information or at least a template of the whole STAC item?

641
elyhienrich
Community Manager 🌎
NJ142
NJ142‎‎ 🌱
asked in Data Access and Management APIs
Drop in revisit rate in 2022 and beyond?

I am working on a project based in Alaska, and put together a script using the API to see how many image-days per month are available in my study region.  However, I noticed a really weird trend in 2022 and beyond, where the average daily images drops by almost 50%.  What is going on here?  I have attached a graph showing data availability with a Planet cloud threshold of 25% image cloud cover (ignore the grey trend line behind, that is unrelated to planet data.)What is going on here with the drop in data coverage? 

581
elyhienrich
Community Manager 🌎
nsruiz00
nsruiz00‎‎ 🌱
asked in Data Access and Management APIs
Order Limit for E&R (Departmental or Campus Package)

Is there a limit to number of orders, given that I use a E&R (Departmental or Campus Package)? I am in the process of requesting a large batch of orders through the API and expect the number of individual orders might exceed 10,000. Thank you! 

2062
elyhienrich
Community Manager 🌎
J
Justin Leong‎‎ 🌱
asked in Data Access and Management APIs
Bad bundle type - unable to accept order

I’m currently trying to download images using the planet api for item_type “PSScene” and product_bundle “basic_analytic_4b”, but I’m getting the error of “Bad bundle type: 'basic_analytic_4b'”.  I already migrated over from PSScene3b but it doesn’t seem to have worked.Is there a new bundle type for the PSScene?Thanks!

8335
elyhienrich
Community Manager 🌎
grit_nm
grit_nm‎‎ 🌱
asked in Data Access and Management APIs
Expanding Batch Order Options Beyond Major Cloud Providers: Can Customer-Owned S3 Storage Replace Hosted Solutions?

Are batch orders exclusively supported on hosted cloud servers, or can customers use their own S3-compatible storage? In other words, why are we locked into providers like AWS and Google Cloud? Customers without access to those cloud services can take advantage of the subscription and tasking services offered by Planet. Is it possible to develop a batch order solution that’s more universally accessible without requiring specific cloud platforms?

2631
elyhienrich
Community Manager 🌎
belen
belen‎‎ 🌱
asked in Data Access and Management APIs
download image 8b surface reflectance with python

             252 / 5.000  Hello, I'd like to know if it's possible to download an image with 8b surface reflectance using Python code. I managed to download it with 4b, specifying the "product_bundle": "analytic_sr_udm2" in the command. However, I tried adding 8b, but it didn't work.

2621
mirons
Community Manager 🌎
Isaxon_Munhuwenhamo
Isaxon_Munhuwenhamo‎‎ 🌱
asked in Data Access and Management APIs
Data Access via API to my GEE Cloud project

I have access to the PlanetScope daily data under the Education and Research. I would want to access it via an API on my Google Earth Engine (GEE) cloud project where I would calculate variables using it such as NDVI then extract pixels for my modeling workflow. without necessarily downloading the full images but extracting portions (pixels) that will form my TFRecords. How may I do this?

3011
A
Planeteer 🌎
emerysilb
emerysilb‎‎ 🌱
asked in Data Access and Management APIs
Education and research XYZ tile server low resolution and downloads credit

Only zoom tiles load atHi,I’m trying to implement the tile server using the education and research license, but it only seems to show a low resolution version of the data. What’s the process to load the full resolution tiles?  Also, I tried using the API to get 13 acres of data using a clip in the API for the AOI, but it used about half my Downloads Scene credit. Is it possible to collect data without having the entire tile count against credit used?  Thank you!  

4042
elyhienrich
Community Manager 🌎
GabiZuccolotto24
GabiZuccolotto24‎‎ 🌱
asked in Data Access and Management APIs
KeyError: 'id' when placing API order

Hello! I’m replicating the code found at this link https://github.com/planetlabs/notebooks/blob/master/jupyter-notebooks/Orders-API/ordering_and_delivery.ipynb with my own set of images and am receiving the error in the screenshot below when trying to place the order. For reference, I’m trying to pull all available analytic_8b_sr_udm2 products that overlap with my specified area of interest.I’m unsure if this is a problem with the API, the images I’m trying to order or the way I’ve written the code. My code is exactly the same as the one linked, except I performed a paginated quick search first and then copy and pasted the resulting item id list into the request code. That item id list has 786 image ids in it. Any insight someone can provide about what is causing this error and how to fix it would be so appreciated! 

3042
idilgumus
Community Manager 🌎
EnglischKäseMensch
EnglischKäseMensch‎‎ 🌱
asked in Data Access and Management APIs
What's the easiest way to download data over a long temporal range?

I'm new to PlanetScope and to mapping. My question is which is the easiest and most time efficient way to download my site data from Planet? I find using the Planet Explorer clear and easy to use, and it lets me clip the image data to just my sites, which is very good as it prevents me from going over my quota. However, I want to download the data for my sites across their whole temporal range (2016 to present day). As far as I can tell, the explorer won't let me do this easily as I have to manually click each scene and press the "load more" button.I've also tried using the official Planet plugin for QGIS. It is cool that it loads Planet data directly into QGIS, but I don't see any option to crop scenes down to just the pixels I want. I also don't see the option to bulk select scenes within a date range. Lastly, I've attempted to use the APIs that Planet provides, but this is challenging because I'm only familiar with the R programming language, so I keep encountering errors. Furthermo

7714
grit_nm
nsruiz00
nsruiz00‎‎ 🌱
asked in Data Access and Management APIs
Expected Time for Downloading Batch

Hello Planet community!  I am looking to perform my first batch download and am wondering if it’s possible to get a ballpark estimate of how long this will take. I have a script prepared in Python using Planet’s API that will facilitate the retrieval and download of about 240 images from PSScene (3m resolution). To anyone with experience doing this, how long will this download process take? Should I run it before going to bed to give it enough time, or is it more recommended to try a parallel processing approach? Any tips are appreciated. 

2631
O
Planeteer 🌎
brunj7
brunj7‎‎ 🌱
asked in Data Access and Management APIs
How to a I create a Geometry Filter from geojson file in Python?

Hi,Is there a way to create a Geometry Filter using defining the AOI directly from a geojson file in Python (ideally using geopandas)? The only examples I am seeing in tutorials is about copy-pasting coordinates, but I hope there is a more automated way to do this.Thank you!

4214
brunj7
DTBeard
DTBeard‎‎ 🌱
asked in Data Access and Management APIs
Interpreting /stats responses

Newby-question here: /stats returns often show millions of “counts” for my searches.  for example:{ "count": 10181598, "start_time": "2016-01-01T00:00:00.000000Z" },Compared to the planet explorer GUI online results with what is (I assume) the same filters, this is an extraordinary difference. I imagine that some of the metadata type files are also included in the “count” in this example, but it still seems like a very high number for my search criteria (which included, for this example, included item_type, permission, publishing, cloud, daterange, and geometry filters all fairly strict). How should I interpret the “count” value from the endpoint response? Are there indeed over 10 million images that meet this criteria? Here is the filter structure for this search: # Search filter setupitem_type = ["PSScene"]AssetFilter = { "type": "AssetFilter", "config": ["ortho_analytic_4b", "ortho_analytic_4b_sr"]}PublishingFilter = { "type": "StringInFilter", "field_name":

3124
DTBeard
edsfernandes
edsfernandes‎‎ 🌱
asked in Data Access and Management APIs
Finding basemap by mosaic_id but not by its name

I have a code that searches for the most recent basemap available.However, when I list all available mosaics, it only returns mosaics until the end of 2023. When I search by name, for example "planet_medres_normalized_analytic_2024-09_mosaic" I can't find this basemap, but when I search directly by its id, I can find it: {'_links': {'_self': 'https://api.planet.com/basemaps/v1/mosaics/02e1d63d-21d6-4355-beed-504c8e3595db?api_key='', 'quads': 'https:/ /api.planet.com/basemaps/v1/mosaics/02e1d63d-21d6-4355-beed-504c8e3595db/quads?api_key=''&bbox={lx},{ly},{ux},{uy}', 'tiles ': 'https://tiles.planet.com/basemaps/v1/planet-tiles/planet_medres_normalized_analytic_2024-09_mosaic/gmap/{z}/{x}/{y}.png?api_key=''}, 'bbox ': [-179.999999974944, -34.161818157002, 179.999999975056, 30.145127179625], 'coordinate_system': 'EPSG:3857', 'datatype': 'uint16', 'first_acquired': '2024-09-01T0 0:00:00.000Z', ' grid': {'quad_size': 4096, 'resolution': 4.777314267823516}, 'id': '02e1d63d-21d6-4355-beed-

3051
Miguel Castro Gomez
Planeteer 🌎
Lamirhl
Lamirhl‎‎ 🌱
asked in Data Access and Management APIs
Clip tool to download images from API

Hello, everyone! I am downloading raster images clipped to 11 small aoi. It appears that my quota allocation is still counting the entire scene’s coverage area towards my monthly download quota, however. Does someone have script to make an order to download clipped images on aoi, for a time series. I will be very grateful as I tried and always get either errors or downloading the whole scenes which impact my monthly quota.Any info will be much appreciated.Thanks!

3992
Lamirhl
S
sbaglapl‎‎ 🌱
asked in Data Access and Management APIs
API Search only returns 250 ids

Hi, I am following the tutorial here to search for images lying within a bounding box. I only get 250 returns back for my aoi. Am I missing something? Please advise :) Cheers,Shashank

6484
O
Planeteer 🌎
I
it0to‎‎ 🌱
asked in Data Access and Management APIs
Best way to go about getting Satellite Imagery on more zoomed in areas of interest?

I am working on a project where I am using satellite imagery to get updates on a basin in Texas. What is the best satellite/service to use in order to get the most clear images returned? I have an Enterprise L Account with Planet. What API should I be using to get the images? What is the best way to make sure I get the most clear images. Anytime it is a bit too zoomed in the images are basically pixels.

3741
elyhienrich
Community Manager 🌎
J
Janne Jääskeläinen
asked in Data Access and Management APIs
Orderding multiple scenes clipped with multiple AOIs

Hi all,I'm building a dataset for training a CNN. For this I need to acquire about 1000 PS scenes clipped to a rather small area of interest (around 600x600m). I've got the item id's and corresponding AOIs as polygons for all the images I need. Since the AOI for each PS scene is so small I want to use the clipping tool from orders API to spare our quota.My question is this: What is the best way to order multiple scenes clipped by multiple areas of interest?I've already written code (in Python) to acquire the images by sending an order for each image separately, but this solution seems a bit "brute-forcy" to me. Is there some more elegant solution to this? I know it is possible to order multiple scenes clipped by a single AOI in a single order but is it possible to order multiple scenes clipped by multiple AOIs?  Thanks for your help!

3302
J
AlidadA
AlidadA‎‎ 🌱
asked in Data Access and Management APIs
Configs definition of keys (gte, gt, lt, lte, gsd ...)

Hi folks,I am working with the Data API and I have a question that is really not covered by documentation (https://developers.planet.com/docs/apis/data/searches-filtering/).What do these configs really mean (gte, gt, lt, lte, gsd...) ? Because some of them store not only one data type, for example lte:In the DateRangeFilter "lte":"2020-01-31T00:00:00Z", but in the RangeFilter it is a float - "lte":0.1, or even an integer (https://developers.planet.com/docs/apis/data/quick-saved-search/ or here https://developers.planet.com/docs/subscriptions/tools/). Thanks!  

17364
AlidadA
A
AndreaMelchiorre‎‎ 🌱
asked in Data Access and Management APIs
how to see all orders?

I created >100 orders using automatic scripts, but I can only retrieve 20 of them, the last 20. How can I see the rest of them?  I get 20 orders both via the python Order API and the web browser….

5623
Miguel Castro Gomez
Planeteer 🌎
A
AndreaMelchiorre‎‎ 🌱
asked in Data Access and Management APIs
What is the maximum number of concurrent Orders I can create?

I need to download a large number of products, I created a script using python API to launch many orders, but after a few orders it stopped with 400 error…. I was wondering what is the maximum number of orders I can queue?

3411
Mariana Curdoglo
Planeteer 🌎
B
belenfh‎‎ 🌱
asked in Data Access and Management APIs
Trying to access imagery outside of my Tier using the Subscription API

Hello Everyone! I am writing this post to ask if anyone knows what happens when you try to download imagery from outside of your signed Tier using the Subscription API. E.g. in my case, I have a contract that lets me download imagery for a given polygon from Japan (Tier 1), so if an user mistakenly tries to download data from, let’s say, the US, my subscription creation will fail and throw an error or will I be charged for this?I already read this documentation, however I could not find an explicit reference to this problem. Although, I am guessing I would get a 403 error (Unauthorized). I would appreciate it if someone could answer my question. Thanks in advance!

3352
B
Z
ZacharyBowyer‎‎ 🌱
asked in Data Access and Management APIs
How to request 4-band basemaps?

Hello, I am trying to figure out how to use either the basemaps api or the orders api to download polygon selections of basemaps. So far, I have this code:  # Order api stuff for basemaps def download_basemap(self, session, request, download_location, file_prefix): #POST request to get data headers = {'content-type': 'application/json'} response = session.post(self.ORDERS_API_URL, data=json.dumps(request), headers=headers) print(response.json()) #Construct url for getting request status order_id = response.json()['id'] order_url = self.ORDERS_API_URL + '/' + order_id #Check request status, once it's done download data while(True): r = session.get(order_url) response = r.json() state = response['state'] print(state) end_states = ['success', 'failed', 'partial'] if state in end_states: break time.sleep(10) #Download data

4301
elyhienrich
Community Manager 🌎
Terms & Conditions
Planet Monitoring
Planet Tasking
Single Order Tasking
Planet Analytic Feeds
Planetary Variables
Planet Basemaps
Planet Insights Platform
Pricing
Broad Area Management
Agriculture
Science Program
Energy & Infrastructure
Forestry & Land Use
Insurance
Mapping
Sustainability
Maritime
Civil Government
US State and Local
Europe
Planet Federal
Defense & Intelligence
Armed Services
Investors
Connect with Planet Partners
Become a Partner
Planet Esri Partnership
Find a Partner
About Us
Customer Stories
Our Team
Careers
Press
Resources
Impact at Planet
Contact Us
Art at Planet
FAQs
Legal Entities
Planet University
Documentation
Help Center
Publications Database
Contact Sales
Explorer Log In
Partner Portal
Investors
Blog
Gallery
Disaster Data
Publications
Planet Insights
Planet Stories

© 2025 Planet Labs PBC. All rights reserved.
| Privacy Policy | California Privacy Notice | California Do Not Sell
Your Privacy Choices | Cookie Notice | Terms of Use