{"library":"pystac-client","title":"PySTAC Client","description":"PySTAC Client is a Python package for searching SpatioTemporal Asset Catalog (STAC) APIs. It builds upon the PySTAC library by offering higher-level functionality and the ability to leverage STAC API search endpoints seamlessly. The current version is 0.9.0, with ongoing active development and regular releases.","language":"python","status":"active","last_verified":"Sun May 17","install":{"commands":["pip install pystac-client"],"cli":null},"imports":["from pystac_client import Client"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\nfrom pystac_client import Client\n\n# Replace with a real STAC API URL or set via environment variable for testing\nSTAC_API_URL = os.environ.get('STAC_API_URL', 'https://earth-search.aws.element84.com/v1')\n\n# 1. Create a client instance\nclient = Client.open(STAC_API_URL)\nprint(f\"Connected to STAC API: {STAC_API_URL}\")\n\n# 2. Perform an item search\nsearch = client.search(\n    max_items=10,\n    collections=['sentinel-2-l2a'],\n    bbox=[-72.5, 40.5, -72, 41]\n)\n\n# 3. Get matched items and print IDs\nmatched_items_count = search.matched()\nprint(f\"Found {matched_items_count} items.\")\n\nprint(\"First 10 item IDs:\")\nfor item in search.items():\n    print(item.id)\n\n# 4. Convert all items to an ItemCollection (use with caution for large results)\n# item_collection = search.item_collection()\n# print(f\"ItemCollection contains {len(item_collection.items)} items.\")","lang":"python","description":"This quickstart demonstrates how to connect to a STAC API, perform a basic item search using geographic bounding box and collection filters, and iterate through the results. It includes a placeholder for a STAC API URL, which can be overridden by an environment variable for easier testing.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-17","installed_version":"0.8.3","pypi_latest":"0.9.0","is_stale":true,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":3.2,"avg_import_s":0.91,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"pystac-client","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.87,"mem_mb":16.2,"disk_size":"28.0M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"pystac-client","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.4,"import_time_s":0.65,"mem_mb":16.2,"disk_size":"28M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"pystac-client","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.1,"mem_mb":17.8,"disk_size":"31.0M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"pystac-client","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.2,"import_time_s":1,"mem_mb":17.8,"disk_size":"31M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"pystac-client","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.97,"mem_mb":17.5,"disk_size":"22.6M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"pystac-client","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2.8,"import_time_s":0.98,"mem_mb":17.5,"disk_size":"23M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"pystac-client","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.98,"mem_mb":18.2,"disk_size":"22.0M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"pystac-client","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2.7,"import_time_s":0.94,"mem_mb":18.2,"disk_size":"22M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"pystac-client","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.8,"mem_mb":16,"disk_size":"26.9M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"pystac-client","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.9,"import_time_s":0.78,"mem_mb":16,"disk_size":"27M"}]}}