Code-Driven Manifesto: How Japan's Local Gov Data Needs an API-First Makeover

どうも〜おかむーです! Hey, Okamu here — today let’s unpack how Japan’s local-government data and systems look from a coder’s lens.
- Local gov has useful datasets (CSV/CSV endpoints) but many reports live in PDFs — machine-unfriendly
- National push for standardization and gov-cloud is right direction, but KPI publication and machine formats need tightening
- Practical fixes: API-first endpoints, JSON Schema, CI for data, and a federated catalogue that actually helps reuse
結論
Japan is on the right path: Digital Agency and Ministry documents (e.g. local government standardization roadmap, Digital Garden City grant evaluations) show policy alignment. But from an engineering POV, operationalizing those goals requires turning PDFs into APIs, making CSVs consistent, and adding automated QA so KPIs are comparable across municipalities.
Report
What I looked at — sources
These are the kinds of sources I scanned: Digital Agency pages on local gov system standardization (https://www.digital.go.jp/policies/local_governments), Ministry of Internal Affairs pages on standardization (https://www.soumu.go.jp/...), CSV endpoints discovered (e.g. https://notice.go.jp/docs/status_notice.csv, https://www.soumu.go.jp/main_content/000323625.csv, env.go.jp CSVs), and policy reports like Digital Garden City grant PDFs (https://www.chisou.go.jp/...). Also public service sites such as keiba.go.jp show content rich services without clear machine APIs.
これ見てくださいよ — machine-readability:
- Many datasets are published as CSV — great! CSV is simple and widely used (see soumu/main_content CSVs and notice.go.jp CSV).
- But PDFs still host KPI narratives and evaluation results. PDFs = opaque to programmatic analysis.
- No consistent API contract across municipalities; field names, encodings, and date formats differ.
エンジニア的に言うと: this is an API design and data engineering problem.
Quick code examples (practical)
Fetch a CSV (bash):
curl -sS "https://www.soumu.go.jp/main_content/000323625.csv" -o data.csv
Python (pandas) to normalize dates and compute a KPI diff:
from pathlib import Path
import pandas as pd
df = pd.read_csv('data.csv', encoding='utf-8')
df['date'] = pd.to_datetime(df['date_column'], errors='coerce')
standardize KPI name
kpi = df.groupby('municipality')['kpi_value'].last()
(要するに: read CSV, normalize columns, compute aggregation — trivial once schema is stable.)
Observations on policy vs reality
- Policy: Standardize core systems, migrate to government cloud, publish KPIs for grant programs (Digital Garden City). See Digital Agency and Chisou guidance.
- Reality: KPI reports often in PDF annexes; where CSVs exist their schemas vary. That makes cross-municipality comparisons manual and error-prone.
Concrete technical proposals
Benefits: faster reuse by startups, better transparency for KPI tracking, easier academic evaluation.
まとめ
- Japan has many building blocks (CSV endpoints, policy roadmaps), but interoperability is the bottleneck.
- Turn PDFs into machine formats, standardize schemas, and add automated QA to make KPI comparisons reliable.
- API-first, catalog-driven approach with shared platform reduces duplication and accelerates innovation.
おかむーから一言
As an entrepreneur and engineer, I want gov data that I can git clone and run tests on! Tech can make public services faster and fairer — let’s ship APIs, not PDFs.
Sources
- https://www.keiba.go.jp/
- https://www.digital.go.jp/policies/local_governments
- https://www.keiba.go.jp/KeibaWeb/TodayRaceInfo/TodayRaceInfoTop
- https://www.soumu.go.jp/menu_seisaku/chiho/jichitaijoho_system/index.html
- https://www.keiba.go.jp/live/
- https://notice.go.jp/docs/status_notice.csv
- https://www.env.go.jp/content/900398071.csv
- https://www.inpit.go.jp/content/100869372.csv
- https://www.mhlw.go.jp/content/001682075.csv
- https://www.soumu.go.jp/main_content/000323625.csv
- https://www.chisou.go.jp/sousei/about/kouhukin/pdf/r6_houkokusho-suishin.pdf
- https://www.chisou.go.jp/sousei/pdf/r5_guideline-checkaction.pdf
- https://www.city.moka.lg.jp/material/files/group/47/r6digitaldennennkouhukinnhyouka.pdf
- https://www.pref.yamaguchi.lg.jp/uploaded/attachment/160746.pdf
- https://www.digital.go.jp/policies/digital_garden_city_nation
Share
Related Reports

Code-driven Manifesto: Auditing Local Gov Data and Systems (Kagawa case study)
Local gov systems run but hide data behind UIs; expose CSV/JSON, APIs, and common schemas to unlock value.

Code-driven Check: Japan’s Open Data and the Machine-Readable Gap
Digital Japan has dashboards and rules, but PDFs and messy formats still block automated policy verification; mandate CSV/JSON, APIs, and dataset linting.

Code Speaks: Testing Japan's Gov Data and Dashboards
Japan has great dashboards but inconsistent machine-readability. This report inspects e-Stat, Japan Dashboard, Kantei PDFs, and proposes API-first fixes and practical code examples.