datacommons-client

# Data Commons Client ## Overview Provides comprehensive access to the Data Commons Python API v2 for querying statistical observations, exploring the knowledge graph, and resolving entity identifiers. Data Commons aggregates data from census bureaus, health organizations, environmental agencies, and other authoritative sources into a unified knowledge graph. ## Installation Install the Data Commons Python client with Pandas support: ```bash uv pip install "datacommons-client[Pandas]" ``` For basic usage without Pandas: ```bash uv pip install datacommons-client ``` ## Core Capabilities The Data Commons API consists of three main endpoints, each detailed in dedicated reference files: ### 1. Observation Endpoint - Statistical Data Queries Query time-series statistical data for entities. See `references/observation.md` for comprehensive documentation. **Primary use cases:** - Retrieve population, economic, health, or environmental statistics - Access historical time-series data for trend analysis - Query data for hierarchies (all counties in a state, all countries in a region) - Compare statistics across multiple entities - Filter by data source for consistency **Common patterns:** ```python from datacommons_client import DataCommonsClient client = DataCommonsClient() # Get latest population data response = client.observation.fetch( variable_dcids=["Count_Person"], entity_dcids=["geoId/06"], # California date="latest" ) # Get time series response = cl...