Skip to main content
Use this guide when you already have a Copernicus datapoint from a Tilebox metadata query and want to access the product files behind it. The example uses Sentinel-2 Level-2A data, but the same storage client pattern applies to Copernicus products supported by Tilebox. Tilebox indexes product metadata as datasets. Product files remain in the Copernicus Data Space Ecosystem, so file access uses the CopernicusStorageClient with Copernicus S3 credentials.

​
Prerequisites

uv add tilebox shapely

​
Select a Sentinel-2 datapoint

Start with a small metadata query and select one datapoint to access. For a deeper guide to open data discovery and metadata filtering, see Query open data metadata.
Python
from shapely import Polygon
from tilebox.datasets import Client

area = Polygon(
    [
        (-109.05, 37.0),
        (-102.05, 37.0),
        (-102.05, 41.0),
        (-109.05, 41.0),
        (-109.05, 37.0),
    ]
)

client = Client()
collection = client.dataset("open_data.copernicus.sentinel2_msi").collection("S2A_S2MSI2A")

scenes = collection.query(
    temporal_extent=("2025-10-01", "2025-11-01"),
    spatial_extent=area,
    show_progress=True,
)

selected = scenes.where(scenes.cloud_cover < 10, drop=True).isel(time=0)
print(selected.granule_name.item())

​
Create the Copernicus storage client

Create a CopernicusStorageClient with your Copernicus S3 credentials. The optional cache_directory controls where downloaded files are stored locally.
Python
from pathlib import Path

from tilebox.storage import CopernicusStorageClient

storage = CopernicusStorageClient(
    access_key="YOUR_COPERNICUS_ACCESS_KEY",
    secret_access_key="YOUR_COPERNICUS_SECRET_ACCESS_KEY",
    cache_directory=Path("./data"),
)
These credentials are Copernicus Data Space S3 credentials, not your Tilebox API key.

​
Download the complete product

Use download when you need the complete Sentinel-2 product directory. The storage client resolves the product location from the Tilebox datapoint metadata and downloads the matching files into the local cache directory.
Python
product_path = storage.download(selected)

print(f"Downloaded {product_path.name} to {product_path}")
print("Contents:")
for path in product_path.iterdir():
    print(f"- {path.relative_to(product_path)}")
Output
Downloaded S2A_MSIL2A_20251002T180751_N0511_R084_T13TEE_20251002T225842.SAFE to data/Sentinel-2/MSI/L2A/2025/10/02/S2A_MSIL2A_20251002T180751_N0511_R084_T13TEE_20251002T225842.SAFE
Contents:
- manifest.safe
- GRANULE
- INSPIRE.xml
- MTD_MSIL2A.xml
- DATASTRIP
- HTML
- rep_info
- S2A_MSIL2A_20251002T180751_N0511_R084_T13TEE_20251002T225842-ql.jpg

​
Download selected product files

Sentinel-2 products contain many files, including metadata, masks, quicklook images, and bands at different resolutions. Use list_objects and download_objects when you only need specific files.
Python
objects = storage.list_objects(selected)

wanted_bands = ["B02_10m", "B03_10m", "B04_10m", "B08_10m"]
band_objects = [
    obj for obj in objects
    if any(band in obj for band in wanted_bands)
]

for obj in band_objects:
    print(obj)

downloaded_files = storage.download_objects(selected, band_objects)
print(downloaded_files)
Use this pattern when a workflow only needs a few bands or metadata files. It reduces transfer time and local storage compared with downloading the full .SAFE product.

​
Preview the product

Many Copernicus products include a quicklook image. In a notebook, use quicklook to display the product preview without downloading the full product first.
Python
storage.quicklook(selected)
Sentinel-2 quicklook image

​
Next steps

Query open data metadata

Find Copernicus products by time, location, and metadata fields.

Storage clients

Learn about the other Tilebox storage clients for open data products.

Access USGS Landsat data

Download Landsat product files with the USGS Landsat storage client.