比較各國通膨
把最新的通膨率排序，並保留每次發布的日期。
閱讀指南 →所有 API
CPI API 與物價通膨
CPI API 可透過 REST 或 MCP 查詢各國官方 CPI 與通膨資料，取得最新採用值、指定期間的數值，或附日期的歷史資料，適合追蹤各國物價走勢。
首次請求
取得最新值
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/USA/cpi?period=2026-07" \
--header "Authorization: Bearer $NARWHAL_API_KEY"端點
GET消費者物價指數/v1/economics/{country}/cpi
取得某個國家在指定月份的整體消費者物價指數。
參數
country必填一個受支援的大寫國家代碼；請參閱此操作的涵蓋清單。
period選填省略此參數可取得已採納的最新完整發布資料，或傳入一個確切期間。
version_id選填選填的不可變發布版本。使用 dataset.published 或 dataset.revised 事件中的 resource_version；省略則讀取目前已收錄的指標。
回應欄位
country字串所請求的大寫 ISO 三字母國家代碼。
period字串回傳的官方觀測期間。
value表示正數的十進位數值字串整體指數值。
index_base字串指數的基期和基值，例如 1982-84=100。
released_on日期官方發布日期，而不是 Narwhal 的檢索時間。
source對象選填的 source 物件僅在統計資料經由分發方取得時出現，包含 publisher（分發方所註明的原始發布方）和 distributor（分發機構）。存在 source 時，released_on 是分發方的發布日期，而不是原始發布方的發布日期。由發布方直接提供的序列沒有 source。
完整參考文件 →
GET消費者物價指數歷史資料/v1/economics/{country}/cpi/observations
取得指定國家目前已接受的消費者物價指數時間序列。
參數
country必填一個受支援的大寫國家代碼；請參閱此操作的涵蓋清單。
start選填起始觀測期間（含該期間）。
end選填結束觀測期間（含該期間）。
limit選填傳回的期間數上限。預設值為 100。頁面可能包含較少的期間；請繼續使用 next_cursor。
cursor選填上一頁回傳的 next_cursor。
version選填只接受 first_reported：回傳每個期間首次儲存的值，並附帶 first_reported_at。不能與 as_of 同時使用。
as_of選填回傳截至指定 UTC 日終時已發布的序列。不能與 version 同時使用。
回應欄位
country字串請求的大寫 ISO alpha-3 國家代碼。每頁傳回一次，不在每筆觀測資料中重複。
start字串僅當 Narwhal 將請求的 start 移至較晚的期間時出現。不會傳回更早的期間。
as_ofRFC 3339 時間戳記來源最後更新本頁最新觀測值的時間，精確到整秒，使用 UTC。
source對象透過資料分發機構取得的統計資料來源資訊；請參閱最新值操作。
index_base字串指數的基期和基值，例如 1982-84=100。一頁不會包含兩種不同基準的資料。
observations陣列按時間由早到晚排列的已採用觀測資料，每個期間一筆。來源缺少的值會省略，絕不補值。每頁觀測資料筆數可能少於 limit；請繼續使用 next_cursor，直到其值為 null。
observations[].period字串觀測值所代表的官方月份或季度。
observations[].first_reported_atRFC 3339 時間戳記僅在 version=first_reported 時出現。這個 UTC 時間戳記錄 Narwhal 首次儲存該期間的時間（如果各項指標是分開儲存的，則取最晚的時間）。在開始擷取之前發布的期間，顯示的是 Narwhal 的首次擷取時間。
observations[].value十進位數值字串已採用的指數水準，不經過二進位浮點數轉換。
next_cursor字串或 null將此值原樣作為 cursor 傳入，以讀取下一頁；最後一頁為 null。
完整參考文件 →
GET通膨/v1/economics/{country}/inflation
取得指定月份的通膨年增率、月增率及年初至今通膨率。
參數
country必填一個受支援的大寫國家代碼；請參閱此操作的涵蓋清單。
period選填省略此參數可取得已採納的最新完整發布資料，或傳入一個確切期間。
version_id選填選填的不可變發布版本。使用 dataset.published 或 dataset.revised 事件中的 resource_version；省略則讀取目前已收錄的指標。
回應欄位
country字串所請求的大寫 ISO 三字母國家代碼。
period字串回傳的官方觀測期間。
year_over_year十進位數值字串與去年同月相比的變動率，單位為百分比。
month_over_month十進位數值字串與上個月相比的變動率，單位為百分比。
year_to_date十進位數值字串與去年十二月相比的變動率，單位為百分比。發布機構未發布時省略。
released_on日期官方發布日期，而不是 Narwhal 的檢索時間。
source對象選填的 source 物件僅在統計資料經由分發方取得時出現，包含 publisher（分發方所註明的原始發布方）和 distributor（分發機構）。存在 source 時，released_on 是分發方的發布日期，而不是原始發布方的發布日期。由發布方直接提供的序列沒有 source。
完整參考文件 →
GET通膨歷史資料/v1/economics/{country}/inflation/observations
取得指定國家目前已接受的通膨時間序列。
參數
country必填一個受支援的大寫國家代碼；請參閱此操作的涵蓋清單。
start選填起始觀測期間（含該期間）。
end選填結束觀測期間（含該期間）。
limit選填傳回的期間數上限。預設值為 100。頁面可能包含較少的期間；請繼續使用 next_cursor。
cursor選填上一頁回傳的 next_cursor。
version選填只接受 first_reported：回傳每個期間首次儲存的值，並附帶 first_reported_at。不能與 as_of 同時使用。
as_of選填回傳截至指定 UTC 日終時已發布的序列。不能與 version 同時使用。
回應欄位
country字串請求的大寫 ISO alpha-3 國家代碼。每頁傳回一次，不在每筆觀測資料中重複。
start字串僅當 Narwhal 將請求的 start 移至較晚的期間時出現。不會傳回更早的期間。
as_ofRFC 3339 時間戳記來源最後更新本頁最新觀測值的時間，精確到整秒，使用 UTC。
source對象透過資料分發機構取得的統計資料來源資訊；請參閱最新值操作。
observations陣列按時間由早到晚排列的已採用觀測資料，每個期間一筆。來源缺少的值會省略，絕不補值。每頁觀測資料筆數可能少於 limit；請繼續使用 next_cursor，直到其值為 null。
observations[].period字串觀測值所代表的官方月份或季度。
observations[].first_reported_atRFC 3339 時間戳記僅在 version=first_reported 時出現。這個 UTC 時間戳記錄 Narwhal 首次儲存該期間的時間（如果各項指標是分開儲存的，則取最晚的時間）。在開始擷取之前發布的期間，顯示的是 Narwhal 的首次擷取時間。
observations[].year_over_year十進位數值字串與去年同月相比的變動率，單位為百分比。
observations[].month_over_month十進位數值字串與上個月相比的變動率，單位為百分比。
observations[].year_to_date十進位數值字串與去年十二月相比的變動率，單位為百分比。發布機構未發布時省略。
next_cursor字串或 null將此值原樣作為 cursor 傳入，以讀取下一頁；最後一頁為 null。
完整參考文件 →
使用情境
涵蓋範圍
指標
國家
來源
- 澳大利亞澳大利亞統計局（ABS）
- 奧地利奧地利統計局、歐盟統計局（Eurostat）
- 比利時比利時統計局（Statbel）、比利時國家銀行、歐盟統計局（Eurostat）
- 加拿大加拿大統計局
- 瑞士瑞士聯邦統計局(FSO)、Eurostat
- 智利智利中央銀行（BCCh）、智利國家統計局（INE）
- 哥倫比亞國家統計行政部（DANE）
- 捷克捷克統計局（ČSÚ）
- 德國德國聯邦統計局（Destatis）
- 丹麥丹麥統計局、歐盟統計局（Eurostat）
- 西班牙西班牙國家統計局（INE）、西班牙稅務局（AEAT）
- 愛沙尼亞愛沙尼亞統計局
顯示全部 36 個來源
- 芬蘭芬蘭統計局、芬蘭海關（Tulli）
- 法國法國國家統計與經濟研究院（INSEE）、法國海關
- 英國英國國家統計局（ONS）
- 克羅埃西亞克羅埃西亞統計局（CBS）
- 愛爾蘭中央統計局（CSO）
- 義大利義大利國家統計局（Istat）、歐盟統計局（Eurostat）
- 日本日本統計局、日本內閣府、日本 Customs
- 立陶宛立陶宛國家資料局
- 盧森堡STATEC、歐盟統計局（Eurostat）
- 拉脫維亞拉脫維亞中央統計局（CSB）
- 墨西哥國家統計、地理與資訊研究所（INEGI）
- 馬來西亞馬來西亞統計局（DOSM）
- 荷蘭荷蘭統計局（CBS）
- 挪威挪威統計局（SSB）
- 菲律賓菲律賓統計局（PSA）
- 波蘭波蘭統計局、歐盟統計局（Eurostat）
- 葡萄牙葡萄牙統計局（INE）
- 卡達National Planning Council (NPC)，透過 Qatar Open Data 入口網站
- 沙烏地阿拉伯統計總局（GASTAT）
- 新加坡新加坡統計局（SingStat）、新加坡政府發布的開放資料
- 斯洛維尼亞斯洛維尼亞共和國統計局（SURS）
- 瑞典瑞典統計局（SCB）
- 美國勞工統計局（BLS）、經濟分析局（BEA）、美國人口普查局
- 巴基斯坦巴基斯坦統計局（PBS）
相關 API
常見問題
CPI 水準與通膨率都有提供嗎？
是。即時涵蓋範圍包含 CPI 指數水準與通膨率。
可以指定特定期間嗎？
是。你可以請求特定期間、取得有日期的歷史資料，或查詢最新採用值。
統計資料從哪裡來？
它們是來自各國官方機構的官方統計，依國家整理。
從免費金鑰開始
12 個月內每月贈送 10 美元免費額度，無需綁卡。每月 10 美元免費額度，無需綁卡。