回到觀點與研究
XMY · 日本市場研究

e-Stat 日本政府統計入口:17 個分野、API 3.0 與商務研究的使用重點

e-Stat 分 17 個分野;API 3.0 版預設單次取得 10 萬件,需註冊取得應用程式 ID。

e-Stat 日本政府統計入口:17 個分野、API 3.0 與商務研究的使用重點主題插畫
謝銘元 XMY · 日本市場研究e-Stat 日本政府統計入口:17 個分野、API 3.0 與商務研究的使用重點

政府統計の総合窓口(e-Stat)是日本政府公開統計資料的總入口,各省廳的調查結果大多可以在這裡以表格、圖形或檔案取得。對做日本市場研究的台灣人來說,e-Stat 的價值在於統一的檢索介面、可下載的原始表格與 API;限制在於資料口徑、調查週期與修訂規則仍由各調查自己決定。以下依 e-Stat 首頁與 API 說明頁整理:首頁的「統計資料搜尋」分成 17 個分野,API 3.0 版自 2019 年 7 月 26 日提供,單次取得上限與註冊規定都有明確數字。本文不討論個別統計的數值,只整理入口的結構與使用規則。

一、入口的結構:分野、組織與加工工具

首頁的「分野から探す」列出 17 類:國土・氣象、人口・世帯、勞動・工資、農林水產業、礦工業、商業・服務業、企業・家計・經濟、住宅・土地・建設、能源・水、運輸・觀光、資訊通信・科學技術、教育・文化・運動・生活、行財政、司法・安全・環境、社會保障・衛生、國際,以及其他。此外還可以依「組織」(內閣官房、總務省、經產省、厚勞省、農水省等)搜尋。找到統計表之後,首頁的「統計資料活用」區提供四種加工方式:統計儀表板(圖表與時間序列表)、地圖(jSTAT MAP)、統計資料下載與境界資料下載。「統計資料高度利用」區則是微觀資料(ミクロデータ)、API 與 LOD。「統計關連資訊」區放有日本標準產業分類、職業分類與商品分類等分類表,研究者需要把統計表的分類代碼對照到自己研究的產業時,可以從這裡開始。首頁另有「公表予定」欄位,可看各統計預定公布的日期。

二、API:版本、功能與數量上限

e-Stat 的 API 讓使用者以程式取得統計資料。API 仕様 3.0 版自 2019 年 7 月 26 日提供,主機名稱為 api.e-stat.go.jp,輸出格式有 XML、JSON、JSONP 與 CSV。要使用 API,必須先完成 e-Stat 的使用者註冊並取得應用程式 ID(appId),每次請求都要指定。3.0 版提供 7 項功能:統計表情報取得、元資訊取得、統計資料取得、資料集登錄、資料集參照、資料目錄資訊取得與統計資料一括取得。主要數量上限為:

項目規定
單次取得件數(limit)省略時為 10 萬件;超過會回傳 NEXT_KEY 供續取
統計資料一括取得所有請求取得的行數合計上限 100000 件
項目代碼指定以逗號分隔,最多 100 個

2019 年 10 月 18 日起,3.0 版可以取得小地區與地區網格(mesh)資料。API 的統計表 ID 並不永久不變:2026 年 7 月 10 日,e-Stat 公告「因消費者物價指數基準改定,API 可用的統計表 ID 等有變更」。依此公告,固定抓取消費者物價指數統計表 ID 的程式,在基準改定後需要重新確認;其他統計若改版,也可能出現類似變更(本站推論),使用前宜查 API 頁的お知らせ。

三、微觀資料:2025 年 3 月 31 日起改為系統受理

若研究需要調查票層級的資料(ミクロデータ),e-Stat 首頁寫明:自令和 7 年(2025 年)3 月 31 日起,調查票資訊的利用申請手續變更,並自該日起依序移行到系統受理。這類資料並非一般的表格下載,各調查的利用資格、費用與期限不一,e-Stat 首頁僅說明手續已改為系統受理,個別條件請見首頁連結的「調查票資訊利用申出手續案內」。

四、使用 e-Stat 做商務研究的限制

e-Stat 彙整的是各省廳的調查(本站解讀):下列限制不會因為放在同一個網站而消失,包括各調查的口徑、母體與調查時點不同,同一個指標(例如物價)會因基準改定而改版,而 API 傳回的是統計表的數值,調查的定義與註記要另外閱讀。把兩個調查的比率相除、或把不同年度的數字並列前,要先讀該調查的「調查概要」與註記。

怎麼做

  1. 先用「分野」或「組織」找到統計名稱,再看該統計的調查概要與公布預定日。
  2. 需要圖表或地圖時,使用首頁的統計儀表板或 jSTAT MAP,免寫程式即可初步探索。
  3. 需要批次取得時,註冊 e-Stat 使用者並取得 appId,依 API 3.0 版規格呼叫,並處理 NEXT_KEY 續取。
  4. 引用統計表時,同時記錄統計表 ID、公布日與取得日,因為 ID 與數值都可能因改版而變。
  5. 需要調查票層級資料時,依首頁的微觀資料說明申請,並確認 2025 年 3 月 31 日起的系統受理流程。

容易踩雷

  • 把 API 預設的 10 萬件當成可無限取得:一括取得合計上限為 100000 件,超出需縮小條件。
  • 把 e-Stat 上的統計表 ID 當成永久代號:2026 年 7 月 10 日的公告顯示,消費者物價指數基準改定時,API 可用的統計表 ID 有變更。
  • 把不同統計的數字直接並列:口徑與調查時點不同。
  • 以為 e-Stat 提供所有政府機關的所有資料:它收錄的是登錄於該窗口的統計(本站解讀:個別機關網站仍可能有 e-Stat 以外的資料)。

常見問題

e-Stat 有哪些統計分野?

首頁列出 17 個分野,包括人口・世帯、勞動・工資、商業・服務業、企業・家計・經濟、運輸・觀光等。

e-Stat API 一次最多取得多少筆?

API 3.0 版的 limit 省略時為 10 萬件;統計資料一括取得時,所有請求的取得行數合計上限為 100000 件。

使用 e-Stat API 需要註冊嗎?

需要,必須先完成 e-Stat 使用者註冊並取得應用程式 ID,每個 API 請求都要指定。

資料來源