API・データの取得

人口・世帯数・人口密度と町丁境界を、読み取り専用のAPIから取得できます。認証やAPIキーは不要です。個人運営の非公式な加工データです。

まず試す

curl 'https://chofu-data.tokyo/api/v1/population/observations?geography_level=municipality&date=latest&metrics=population,households'

応答の data に数値、meta に適用条件・単位・収録範囲・出典・注意事項を含みます。latest は「このサイトの最新収録日」で、市の最新公表日と一致することを確認したものではありません。

内容	GETのパス
公開データセットの一覧	`/api/v1/datasets`
定義・単位・収録日・出典・制約	`/api/v1/datasets/{dataset_id}`
区域名・IDの検索	`/api/v1/areas`
人口・世帯数・人口密度の取得	`/api/v1/population/observations`
町丁境界の属性とGeoJSON取得先	`/api/v1/boundaries/{area_id}`

入力・出力の完全な定義：OpenAPI（JSON）。MCPは後続の実装対象です。

人口は geography_level=municipality（市全体）または town_area（町丁別）を指定します。
日付は date=2026-10-01、date=latest、または from=2025-10-01&to=2026-10-01 で指定します。
指標は metrics=population,male,female,households,density から選べます。省略時は人口計です。人口密度は町丁別のみ提供します。
町丁を絞るときは、先に区域名を検索してから area_ids にIDをカンマ区切りで最大10件指定します。候補を自動で1町丁に確定しません。
標準100行・最大500行です。meta.pagination.next_url がある場合は、そのURLをそのままたどります。人口は基準日・区域IDの昇順です。大量取得は下の静的データを利用してください。

null は0ではありません。原表空欄は source_blank、原表未掲載は not_in_source です。未収録の単一日を指定すると理由付きエラーを返します。期間指定では収録済みの日付だけを返し、未収録月をメタデータに示します。補間はしません。

再現可能な分析には、応答の data_revision を保存し、次回の取得条件にも指定してください。続きのURLは自動で同じ版を固定します。市全体の値は原本Excelの合計値です。人口を異なる基準日で合計したり、市全体と町丁別の行を混ぜて合計したりしないでください。人口密度も合計しません。

人口密度の分母は2020年国勢調査境界の面積で、公園・河川を含みます。境界取得APIは面積・代表点・外接矩形と全町丁GeoJSONへのリンクを返し、大きな図形データを応答本文には含めません。

データカタログから、版付きのJSON・CSV・GeoJSONと定義・出典・加工履歴・品質情報を取得できます。既存の静的データは引き続き利用できます。

人口データはCC BY 4.0、境界データはe-Stat利用規約など、応答に含まれる各出典の条件に従ってください。出典と加工した旨を示し、CSVにも対応する定義・出典情報を添えて利用してください。詳しくは出典・利用についてを参照してください。

GET・HEAD・OPTIONSに対応し、外部のブラウザからも取得できます。ETagによる再検証に対応します。APIは無料枠で運用するため、稼働率や応答速度は保証しません。APIが使えない場合も、静的データの一括取得を利用できます。

APIの版は /v1、データの版は data_revision で別に管理します。未知の条件・不正な日付・未対応の指標などは理由付きJSONエラーになります。