Google Data Commons

Resolves places, fetches their hierarchy, and retrieves geographic coordinates (latitude/longitude)

Custom Streaming + One-shot

Resolves places, fetches their hierarchy, and retrieves geographic coordinates (latitude/longitude). Use `child_type` to find specific descendants.

Technical details

Authentication ▾

Ingestion ▾

Mode: Streaming + One-shot

Tools exposed (5) ▾

get_geographic_context

Resolves places, fetches their hierarchy, and retrieves geographic coordinates (latitude/longitude). Use `child_type` to find specific descendants.

get_observations

Query the Data Commons Knowledge Graph for quantitative data (population, economics, demographics, health, climate, etc.) given variable DCIDs and place DCIDs. Use this tool for ALL data requests.

search_indicators

Searches for multiple statistical variables in parallel. Returns a consolidated list of candidates.

upsert_bento_get_geographic_context

Create or update a recurring check for geographic hierarchy updates. Useful for tracking changes in region definitions over time (though rare). Same arguments as get_geographic_context plus polling_frequency.

upsert_bento_get_observations

Create or update a recurring data feed for Data Commons observations. Use this when the user wants to track data over time (Realtime/Hourly/Daily). Same arguments as get_observations plus polling_frequency.

Inputs ▾

get_geographic_context

Name Type Required Description

dashboardId string no Target dashboard/initiative ID. Omit to use the current dashboard.

places object[] yes

Nested schema for places

Name	Type	Required	Description
query	string	yes	e.g., "Bangor, Maine"
type	string	no	Type of the PARENT place (e.g. "State") `Country` `State` `Province` `County` `City` `Town` `Village` `PostalCode` `AdministrativeArea1` `AdministrativeArea2` `CensusTract` `CensusZipCodeTabulationArea` `Continent` `Borough` `Neighborhood` `AdministrativeArea3` `AdministrativeArea4` `AdministrativeArea5` `SchoolDistrict` `ElementarySchoolDistrict` `HighSchoolDistrict` `UnifiedSchoolDistrict` `CongressionalDistrict` `StateSenateDistrict` `StateAssemblyDistrict` `EurostatNUTS1` `EurostatNUTS2` `EurostatNUTS3` `Commune` `GeoGridPlace_1Deg` `IPCCPlace_50` `Lake` `Place`
child_type	string	no	Filter descendants by this type (e.g. "County" to get all counties in the parent). `Country` `State` `Province` `County` `City` `Town` `Village` `PostalCode` `AdministrativeArea1` `AdministrativeArea2` `CensusTract` `CensusZipCodeTabulationArea` `Continent` `Borough` `Neighborhood` `AdministrativeArea3` `AdministrativeArea4` `AdministrativeArea5` `SchoolDistrict` `ElementarySchoolDistrict` `HighSchoolDistrict` `UnifiedSchoolDistrict` `CongressionalDistrict` `StateSenateDistrict` `StateAssemblyDistrict` `EurostatNUTS1` `EurostatNUTS2` `EurostatNUTS3` `Commune` `GeoGridPlace_1Deg` `IPCCPlace_50` `Lake` `Place`

get_observations

Name	Type	Required	Description
dashboardId	string	no	Target dashboard/initiative ID. Omit to use the current dashboard.
variable_dcids	string[]	yes
place_dcids	string[]	no	Place DCIDs to query (e.g. ['country/USA', 'geoId/06']). Required — pass at least one.
date	string	yes	Fetch observations matching the specified date(s) and time(s). "LATEST" for the most recent, "" for all dates, or an ISO-8601 date.
filter_paths	string[]	no	Optional list of glob patterns to filter the result (e.g. ['byVariable.population.**']). Use this to reduce context usage by removing unneeded data.

search_indicators

Name	Type	Required	Description
queries	string[]	no	List of search terms (e.g., ["poverty", "health", "education"])
query	string[]	no	Alias for queries

upsert_bento_get_geographic_context

Name Type Required Description

dashboardId string no Target dashboard/initiative ID. Omit to use the current dashboard.

places object[] yes

Nested schema for places

Name	Type	Required	Description
query	string	yes	e.g., "Bangor, Maine"
type	string	no	Type of the PARENT place (e.g. "State") `Country` `State` `Province` `County` `City` `Town` `Village` `PostalCode` `AdministrativeArea1` `AdministrativeArea2` `CensusTract` `CensusZipCodeTabulationArea` `Continent` `Borough` `Neighborhood` `AdministrativeArea3` `AdministrativeArea4` `AdministrativeArea5` `SchoolDistrict` `ElementarySchoolDistrict` `HighSchoolDistrict` `UnifiedSchoolDistrict` `CongressionalDistrict` `StateSenateDistrict` `StateAssemblyDistrict` `EurostatNUTS1` `EurostatNUTS2` `EurostatNUTS3` `Commune` `GeoGridPlace_1Deg` `IPCCPlace_50` `Lake` `Place`
child_type	string	no	Filter descendants by this type (e.g. "County" to get all counties in the parent). `Country` `State` `Province` `County` `City` `Town` `Village` `PostalCode` `AdministrativeArea1` `AdministrativeArea2` `CensusTract` `CensusZipCodeTabulationArea` `Continent` `Borough` `Neighborhood` `AdministrativeArea3` `AdministrativeArea4` `AdministrativeArea5` `SchoolDistrict` `ElementarySchoolDistrict` `HighSchoolDistrict` `UnifiedSchoolDistrict` `CongressionalDistrict` `StateSenateDistrict` `StateAssemblyDistrict` `EurostatNUTS1` `EurostatNUTS2` `EurostatNUTS3` `Commune` `GeoGridPlace_1Deg` `IPCCPlace_50` `Lake` `Place`

polling_frequency

string

yes

How often to check for new data.

realtime 1m 5m 1h 6h 24h

description string no Human-readable description of what this connector monitors. Shown to analysts in future sessions.

connectorId string no If provided, updates the existing connector instead of creating a new one.

upsert_bento_get_observations

Name	Type	Required	Description
dashboardId	string	no	Target dashboard/initiative ID. Omit to use the current dashboard.
variable_dcids	string[]	yes
place_dcids	string[]	no	Place DCIDs to query (e.g. ['country/USA', 'geoId/06']). Required — pass at least one.
date	string	yes	Fetch observations matching the specified date(s) and time(s). "LATEST" for the most recent, "" for all dates, or an ISO-8601 date.
filter_paths	string[]	no	Optional list of glob patterns to filter the result (e.g. ['byVariable.population.**']). Use this to reduce context usage by removing unneeded data.
polling_frequency	string	yes	How often to check for new data (e.g. '15m', '1h').
description	string	no	Human-readable description of what this connector monitors. Shown to analysts in future sessions.
connectorId	string	no	If provided, updates the existing connector instead of creating a new one.

Google Data Commons