Narwhal ドキュメント
日本語
APIリファレンスサイト
すべてのドキュメントを閲覧

Economics APIリファレンス

10か国にわたる最新リリースと過去の観測値。

9つのルートが最新の受け入れ済み公式リリースを返します。対応する9つの /observations ルートは現在受け入れられている時系列を返します。REST と MCP は同じスキーマを使用し、同じ月間クォータを消費します。

ベースURLとパラメータ

REST ベースパス
https://api.narwhalapi.com/v1/economics/{country}
  • country サポート対象の大文字 ISO alpha-3 コードです。
  • period 任意です。最新リリースでは省略するか、操作に対応する月、四半期、年の形式を指定します。
  • すべてのリクエストには、次で説明する Bearer ヘッダーが必要です： 認証.
既知の期間を1つリクエスト
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/cpi?period=2026-07" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

国

AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP、および USA.

すべての国で、同じ9つの最新操作と9つの履歴操作を利用できます。

最新リリース

操作ページを開くと、正確なパラメータ、受け付ける期間形式、レスポンスフィールド、例、エラー、鮮度、現在の上限を確認できます。

操作REST パス期間
消費者物価指数/v1/economics/{country}/cpiYYYY-MM
インフレ/v1/economics/{country}/inflationYYYY-MM
失業率/v1/economics/{country}/unemploymentYYYY, YYYY-MM, or YYYY-QN
労働力率/v1/economics/{country}/labour-force-participationYYYY, YYYY-MM, or YYYY-QN
国内総生産/v1/economics/{country}/gdpYYYY-QN
GDP 成長率/v1/economics/{country}/gdp-growthYYYY-QN
商品貿易/v1/economics/{country}/tradeYYYY or YYYY-MM
商品輸出/v1/economics/{country}/trade/exportsYYYY or YYYY-MM
商品輸入/v1/economics/{country}/trade/importsYYYY or YYYY-MM

過去の観測値

過去データのルートで受け付けるのは start, end, limit、および cursor。結果は古い順で、過去の公開版すべてではなく、現在受け入れられている系列を示します。

操作REST パス期間
消費者物価指数の履歴/v1/economics/{country}/cpi/observationsYYYY-MM
インフレ履歴/v1/economics/{country}/inflation/observationsYYYY-MM
失業率の履歴/v1/economics/{country}/unemployment/observationsYYYY, YYYY-MM, or YYYY-QN
労働力率の履歴/v1/economics/{country}/labour-force-participation/observationsYYYY, YYYY-MM, or YYYY-QN
国内総生産の履歴/v1/economics/{country}/gdp/observationsYYYY-QN
GDP 成長率の履歴/v1/economics/{country}/gdp-growth/observationsYYYY-QN
商品貿易履歴/v1/economics/{country}/trade/observationsYYYY-MM
商品輸出履歴/v1/economics/{country}/trade/exports/observationsYYYY-MM
商品輸入履歴/v1/economics/{country}/trade/imports/observationsYYYY-MM

フィールド規則

フィールドまたは規則意味
country指定された ISO alpha-3 国コード。
periodレスポンスが表す正確な公式の月、四半期、または年。
released_onNarwhal の取得時刻ではなく、公式公開日。
小数文字列経済数値は正確な10進表現を保つため文字列です。
単位と基準該当する場合、レート、通貨、価格基準、年率換算、カバレッジ、指数基準は明示されたままです。
欠落したリリースNarwhalは捏造、繰り越し、欠落値のゼロ変換をせず、失敗として処理します。

OpenAPI と検索

現在の公開ベータ版の制限

公開検索の対象は、上記の18ルートと10か国に限られます。インドネシアと地域ルートは、公開 Economics ベータの対象外です。

参照： エラーとクォータ 系列欠損とサービス利用不能時の動作向け。