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
1四半期の国全体の GDP を取得します。常に当期価格です。
パラメータ
country必須対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。
period任意受け入れ済みの完全な公表データのうち最新のものを取得するには省略します。特定の期間を1つ指定することもできます。
version_id任意任意の不変な公開バージョン。dataset.published または dataset.revised イベントの resource_version を使います。省略すると現在承認されている指標を読み取ります。
レスポンスフィールド
country文字列指定された大文字 ISO alpha-3 国コード。
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
1つの国について、現在受け入れられている国内総生産の時系列を取得します。
パラメータ
country必須対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。
start任意最初の観測期間（その期間を含む）。
end任意最後の観測期間（その期間を含む）。
limit任意返す期間数の上限。デフォルトは 100 です。1ページの期間数がこれより少ない場合もあるため、next_cursor をたどってください。
cursor任意前のページの next_cursor。
version任意first_reported のみ受け付けます。各期間について最初に保存された値を first_reported_at とともに返します。as_of とは併用できません。
as_of任意指定した UTC 日の終わりまでに公表されていたとおりの系列を返します。version とは併用できません。
レスポンスフィールド
country文字列リクエストした大文字の ISO alpha-3 国コード。観測値ごとではなく、ページごとに1回返します。
start文字列Narwhal がリクエストした start を後の期間に移動した場合にのみ含まれます。それより前の期間は返しません。
as_ofRFC 3339 タイムスタンプこのページの最新の観測値をソースが最後に更新した時刻。UTC、秒単位です。
sourceオブジェクト配信事業者を通じて受け取った統計の出所情報。最新値を取得する操作を参照してください。
currencyISO 4217 文字列ページ内のすべての値に共通する自国通貨。
not_seasonally_adjusted真数値が季節調整されていない場合にのみ、true として含まれます。
annualized真数値が年率換算されている場合にのみ、true として含まれます。
observations配列採用済みの観測値を古い順に、各期間につき1件返します。ソースにない値は省略し、補完しません。1ページの観測値の件数が 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
1四半期の公式実質 GDP 成長率を取得します。固定価格で測定し、パーセントで表します。
パラメータ
country必須対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。
period任意受け入れ済みの完全な公表データのうち最新のものを取得するには省略します。特定の期間を1つ指定することもできます。
version_id任意任意の不変な公開バージョン。dataset.published または dataset.revised イベントの resource_version を使います。省略すると現在承認されている指標を読み取ります。
レスポンスフィールド
country文字列指定された大文字 ISO alpha-3 国コード。
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
1つの国について、現在受け入れられている GDP 成長率の時系列を取得します。
パラメータ
country必須対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。
start任意最初の観測期間（その期間を含む）。
end任意最後の観測期間（その期間を含む）。
limit任意返す期間数の上限。デフォルトは 100 です。1ページの期間数がこれより少ない場合もあるため、next_cursor をたどってください。
cursor任意前のページの next_cursor。
version任意first_reported のみ受け付けます。各期間について最初に保存された値を first_reported_at とともに返します。as_of とは併用できません。
as_of任意指定した UTC 日の終わりまでに公表されていたとおりの系列を返します。version とは併用できません。
レスポンスフィールド
country文字列リクエストした大文字の ISO alpha-3 国コード。観測値ごとではなく、ページごとに1回返します。
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配列採用済みの観測値を古い順に、各期間につき1件返します。ソースにない値は省略し、補完しません。1ページの観測値の件数が 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）
- オーストリアStatistics Austria、Eurostat
- ベルギーStatbel、ベルギー国立銀行、Eurostat
- カナダカナダ統計局
- チリチリ中央銀行（BCCh）、チリ国立統計研究所（INE）
- コロンビア国家統計行政局（DANE）
- チェコチェコ統計局（ČSÚ）
- ドイツドイツ連邦統計局（Destatis）
- デンマークStatistics Denmark、Eurostat
- スペインスペイン国立統計研究所（INE）、スペイン税務庁（AEAT）
- エストニアStatistics Estonia
- フィンランドStatistics Finland、フィンランド税関（Tulli）
36 件のソースをすべて表示
- フランス国立統計経済研究所（INSEE）、フランス税関
- 英国英国国家統計局（ONS）
- クロアチアクロアチア統計局（CBS）
- アイルランドCentral Statistics Office (CSO)
- イタリアイタリア国立統計研究所（Istat）、Eurostat
- 日本総務省統計局、日本の内閣府、日本税関
- リトアニアリトアニア国家データ庁
- ルクセンブルクSTATEC、Eurostat
- ラトビアラトビア中央統計局（CSB）
- メキシコ国立統計地理情報院（INEGI）
- マレーシアマレーシア統計局（DOSM）
- オランダオランダ統計局（CBS）
- ノルウェーStatistics Norway（SSB）
- ニュージーランドStats NZ
- パキスタンパキスタン統計局（PBS）
- フィリピンフィリピン統計局（PSA）
- ポーランドStatistics Poland、Eurostat
- ポルトガルStatistics Portugal（INE）
- カタールNational Planning Council (NPC)（Qatar Open Data ポータル経由）
- サウジアラビア統計総局（GASTAT）
- シンガポールシンガポール統計局（SingStat）、シンガポール政府のオープンデータ公開資料
- スロベニアスロベニア共和国統計局（SURS）
- スウェーデンStatistics Sweden（SCB）
- 米国労働統計局（BLS）、経済分析局（BEA）、米国国勢調査局
関連 API
よくある質問
ライブの対象範囲にGDP成長率は含まれますか。
はい。GDP水準とGDP成長率の両方を、現在ライブで提供しています。
特定の報告期間を指定して照会できますか。
はい。正確な期間を指定することも、日付付きの履歴を取得することもできます。
出力データはどこから取得していますか。
APIは、各国の統計機関が公表する公式統計を、国別に整理して提供しています。
無料キーで始めましょう
12か月間、毎月10ドル分の無料クレジット。カードは不要です。毎月10ドル分の無料クレジット。カードは不要です。