landstac Documentation

Search and download Landsat imagery from USGS with Python.

landstac connects to the USGS LandsatLook STAC API to search Landsat Collection 2 data and download protected assets with authentication.

Core capabilities

• Search: Find Landsat scenes by location, date, and cloud cover

• Authenticate: Handle USGS login automatically

• Download: Get individual bands or full scenes

• Stack: Combine bands into multi-band GeoTIFFs

• Stream: Access data without downloading via GDAL integration

Available Collections

The LandsatLook STAC API provides access to Landsat Collection 2 datasets:

Collection ID	Product Level	Description
landsat-c2l1	Level-1	TOA reflectance and brightness temperature
landsat-c2l2-sr	Level-2 UTM	Surface Reflectance (SR) Product
landsat-c2l2-st	Level-2 UTM	Surface Temperature (ST) Product
landsat-c2l2alb-sr	Level-2 Albers	Albers Surface Reflectance (SR) Product
landsat-c2l2alb-st	Level-2 Albers	Albers Surface Temperature (ST) Product
landsat-c2l2alb-bt	Level-2 Albers	Albers Top of Atmosphere Brightness Temperature (BT) Product
landsat-c2l2alb-ta	Level-2 Albers	Albers Top of Atmosphere (TA) Reflectance Product
landsat-c2l3-fsca	Level-3	Fractional Snow Covered Area (fSCA) Product
landsat-c2l3-ba	Level-3	Burned Area (BA) Product
landsat-c2l3-dswe	Level-3	Dynamic Surface Water Extent (DSWE) Product
landsat-c2ard-sr	ARD	Analysis Ready Data Surface Reflectance (SR) Product
landsat-c2ard-st	ARD	Analysis Ready Data Surface Temperature (ST) Product
landsat-c2ard-bt	ARD	Analysis Ready Data Top of Atmosphere Brightness Temperature (BT) Product
landsat-c2ard-ta	ARD	Analysis Ready Data Top of Atmosphere (TA) Reflectance Product

For an updated list of available collections, visit: https://stacindex.org/catalogs/usgs-landsat-collection-2-api

Supported sensors include Landsat 4-5 TM, Landsat 7 ETM+, Landsat 8 OLI/TIRS, and Landsat 9 OLI-2/TIRS-2.

Contents:

• Installation
  • Requirements
  • Install from PyPI
  • Development Installation
  • Dependencies
  • Authentication Setup
  • Verification
• Examples
  • 1. Search for Data
  • 2. Authentication
  • 3. Read Files in Memory
  • 4. Read with Overview
  • 5. Export Files to Drive
  • 6. Working with Multiple Collections
  • 7. Working with Utility Functions
• API Reference
  • landstac.auth
  • landstac.stac
  • landstac.download
  • landstac.read
  • landstac.utils
  • landstac.exceptions
  • landstac.types

Getting Started

Install the package and start searching Landsat data:

pip install landsatlook-stac

import landstac

stac = landstac.LandsatLookSTAC()
items = stac.search(
    collections=["landsat-c2l2-sr"],
    max_items=10
)

See the Installation guide for detailed setup instructions and the Examples page for comprehensive usage examples.

Support & Contact

Author: Pratyush Tripathy

Found a bug or have a feature request? Please report issues on the GitHub Issues page.

Contributions and feedback are welcome!

Citation

If you use this software in your research, please cite it:

@software{tripathy_landstac_2025,
  author       = {Tripathy, Pratyush},
  title        = {PratyushTripathy/landstac},
  year         = 2025,
  publisher    = {Zenodo},
  doi          = {10.5281/zenodo.17168071},
  url          = {https://github.com/PratyushTripathy/landstac}
}

Quick Links

• STAC Browser: https://landsatlook.usgs.gov/stac-browser/

• Collection Catalog: https://stacindex.org/catalogs/usgs-landsat-collection-2-api

• USGS ERS Registration: https://ers.cr.usgs.gov/register/