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