GDP 成長率 API

1四半期の公式実質 GDP 成長率を取得します。固定価格で測定し、パーセントで表します。

economics_get_gdp_growth を利用できるのは REST と、 economics_get_gdp_growth という MCP ツールです。どちらも同じデータ形式を返し、同じ月間クォータを消費します。

エンドポイントとリクエスト

REST エンドポイント

GET /v1/economics/{country}/gdp-growth

リクエストの例

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/gdp-growth?period=2026-Q2" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCP で使用するツールは economics_get_gdp_growth です。以下の対応する引数を指定します。

パラメータ

この操作で受け付ける期間形式： YYYY-QN。

名前	必須	種別	意味
`country`	はい	パス · ISO alpha-3	対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。
`period`	いいえ	クエリ · YYYY-QN	受け入れ済みの完全な公表データのうち最新のものを取得するには省略します。特定の期間を1つ指定することもできます。
`version_id`	いいえ	クエリ · UUID	省略可能な変更不可の公開版です。`dataset.published`または`dataset.revised`イベントの`resource_version`を指定できます。省略すると、現在採用されている指標を取得します。

レスポンス

レスポンスの例

{
  "country": "USA",
  "period": "2026-Q2",
  "year_over_year": "2.4",
  "quarter_over_quarter": "0.503",
  "released_on": "2026-07-30"
}

フィールド	種別	必須	意味
`country`	文字列	はい	指定された大文字 ISO alpha-3 国コード。
`period`	文字列	はい	返される公式観測期間。
`year_over_year`	小数文字列	はい	前年の同じ四半期からの実質 GDP の変化率。単位はパーセントです。
`quarter_over_quarter`	小数文字列	はい	前四半期からの実質 GDP の変化率。単位はパーセントです。年率換算されていません。
`year_to_date`	小数文字列	いいえ	ソースが公表する場合に返す公式の年初来成長率。単位はパーセントです。公表されていない場合は省略します。
`not_seasonally_adjusted`	`true`	いいえ	成長率が季節調整されていない場合にのみ、true として含まれます。
`annualized`	`true`	いいえ	公表された成長率が年率換算されている場合にのみ、true として含まれます。
`year_over_year_not_seasonally_adjusted`	`true`	いいえ	複数の基準が混在する国で、前年同期比の数値が季節調整されていない場合にのみ、true として含まれます。この場合、最上位のフラグは含まれません。
`quarter_over_quarter_not_seasonally_adjusted`	`true`	いいえ	複数の基準が混在する国で、前四半期比の数値が季節調整されていない場合にのみ、true として含まれます。この場合、最上位のフラグは含まれません。
`released_on`	日付	はい	Narwhal の取得時刻ではなく、公式の公表日。
`source`	オブジェクト	いいえ	任意の `source` オブジェクトは、統計を配信事業者経由で受け取る場合にのみ含まれます。`publisher`（配信事業者が示す元の公表元）と `distributor`（配信を行う組織）を含みます。`source` がある場合、`released_on` は配信事業者の公表日であり、元の公表元の公表日ではありません。公表元から直接取得する系列では `source` を省略します。

エラーとクォータ

400 invalid_query — 国、期間、フィルター形式が無効です。
401 invalid_api_key — Bearer キーがないか拒否されました。
403 plan_upgrade_required — 指定期間または範囲が、プランの履歴対象期間（Freeは12か月、Basicは5年）より前に終了します。
404 series_not_found — リクエストに一致する承認済み観測値がありません。
429 rate_limit_exceeded — ネットワークまたはアカウントの短時間枠の上限に達しました。再試行は、次のヘッダーの指定に従って待機してから行ってください： Retry-After。
429 quota_exhausted — アカウントが月間枠に達しました。
503 economics_unavailable — Narwhal は受け入れ済み公開データを安全に提供できません。

クォータを消費するのは成功したデータレスポンスだけです。次を参照：すべてのエラー、ヘッダー、再試行規則。

鮮度

省略 period を省略すると、Narwhal が保存している受け入れ済みの最新リリースを返します。API 呼び出しは Narwhal のデータベースを読み取り、公式の公表機関をリアルタイムで呼び出しません。

released_on は公式の公表日です。

読むソース確認、検証、保存済みリリース、確認失敗の仕組み。

現在の公開ベータ版カバレッジ

36 国

AUS, AUT, BEL, CAN, CHL, COL, CZE, DEU, DNK, ESP, EST, FIN, FRA, GBR, HRV, IRL, ITA, JPN, LTU, LUX, LVA, MEX, MYS, NLD, NOR, NZL, PAK, PHL, POL, PRT, QAT, SAU, SGP, SVN, SWE, USA

四半期の前年同期比と前期比の成長率の対象国は、下記の国一覧に従います。任意のyear_to_dateフィールドは、公式ソースが公表する場合にのみ含まれます。

インドネシアと地域別の経済データルートは公開されていません。日次 FX データの提供先は為替API。

戻る：すべての経済データ操作。