datacommons-client

1# Data Commons Client
2 
3## Overview
4 
5Provides 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.
6 
7## Routing Boundary
8 
9Use this skill when the user explicitly asks for Data Commons/datacommons, Data Commons statistical variables, Data Commons entities/DCIDs, or population/economic indicators that fit the Data Commons knowledge graph.
10 
11Generic public data, open data, public dataset search, or public download-link collection by itself is not enough to select this skill. Those requests need a clearer Data Commons/statistical-graph signal before this skill becomes the route owner.
12 
13## Installation
14 
15Install the Data Commons Python client with Pandas support:
16 
17```bash
18uv pip install "datacommons-client[Pandas]"
19```
20 
21For basic usage without Pandas:
22```bash
23uv pip install datacommons-client
24```
25 
26## Core Capabilities
27 
28The Data Commons API consists of three main endpoints, each detailed in dedicated reference files:
29 
30### 1. Observation Endpoint - Statistical Data Queries
31 
32Query time-series statistical data for entities. See `references/observation.md` for comprehensive documentation.
33 
34**Primary use cases:**
35- Retrieve population, economic, health, or environmental statistics
36…