search_items
Search for geospatial items across STAC APIs using spatial, temporal, and property filters to retrieve satellite imagery and other assets.
Instructions
Search for STAC items.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | List of specific item IDs to retrieve. | |
| bbox | No | Bounding box [west, south, east, north] or GeoJSON geometry. | |
| limit | No | Maximum number of items to return. | |
| query | No | Query filter for properties. | |
| fields | No | List of fields to include/exclude (e.g., ["id", "properties.datetime"]). Prefix with "-" to exclude (e.g., ["-properties.eo:cloud_cover"]). | |
| sortby | No | Sort order (e.g., ["-properties.datetime"] for descending, ["+properties.datetime"] for ascending). | |
| datetime | No | Datetime filter (e.g., "2020-01-01/2020-12-31"). | |
| intersects | No | GeoJSON geometry for spatial intersection query. | |
| catalog_url | No | Optional catalog URL override. | |
| collections | No | One or more collection IDs to search. | |
| sign_assets | No | If True and catalog is Planetary Computer, sign asset URLs for direct access. Requires planetary-computer package. | |
| output_format | No | Output format ("text" or "json"). | text |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |