すべてのAPI

物価とインフレの消費者物価指数API

消費者物価指数APIで、国別の公式なCPIとインフレのデータをRESTまたはMCPで照会。受理済みの最新値、指定期間の値、日付付きの履歴を取得できます。

稼働中99.94% uptime, last 30日378 ms 標準応答

最初のリクエスト

最新の値を取得する

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

1つの国と月について、総合消費者物価指数を取得します。

パラメータ

  • country必須

    対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。

  • period任意

    受け入れ済みの完全な公表データのうち最新のものを取得するには省略します。特定の期間を1つ指定することもできます。

  • version_id任意

    任意の不変な公開バージョン。dataset.published または dataset.revised イベントの resource_version を使います。省略すると現在承認されている指標を読み取ります。

レスポンスフィールド

  • country文字列

    指定された大文字 ISO alpha-3 国コード。

  • period文字列

    返される公式観測期間。

  • value正の小数文字列

    総合指数水準。

  • index_base文字列

    指数の基準期間と基準値。例:1982-84=100。

  • released_on日付

    Narwhal の取得時刻ではなく、公式の公表日。

  • sourceオブジェクト

    任意の source オブジェクトは、統計が配信元経由で届いた場合にだけ現れます。publisher(配信元が示す元の発表機関)と distributor(配信した組織)を含みます。source がある場合、released_on は配信元の公表日であり、元の発表機関の発表日ではありません。発表機関から直接届く系列には source がありません。


リファレンス全文 →
GET消費者物価指数の履歴/v1/economics/{country}/cpi/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オブジェクト

    配信事業者を通じて受け取った統計の出所情報。最新値を取得する操作を参照してください。

  • index_base文字列

    指数の基準期間と基準値。例:1982-84=100。1ページに異なる2つの基準のデータが混在することはありません。

  • observations配列

    採用済みの観測値を古い順に、各期間につき1件返します。ソースにない値は省略し、補完しません。1ページの観測値の件数が limit より少ない場合もあるため、next_cursor が null になるまでたどってください。

  • observations[].period文字列

    観測値が表す公式の月または四半期。

  • observations[].first_reported_atRFC 3339 タイムスタンプ

    version=first_reported のときだけ現れます。この UTC タイムスタンプは、Narwhal がその期間を最初に保存した時刻です(指標が別々に保存された場合は最も遅い時刻)。取得開始前に公表された期間には、Narwhal の最初の取得時刻が入ります。

  • observations[].value小数文字列

    採用済みの指数水準。2進浮動小数点数への変換は行いません。

  • next_cursor文字列または null

    次のページを読むには、この値を変更せず cursor に渡してください。最終ページでは null です。


リファレンス全文 →
GETインフレ率/v1/economics/{country}/inflation

1か月の前年同月比、前月比、年初来のインフレ率を取得します。

パラメータ

  • country必須

    対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。

  • period任意

    受け入れ済みの完全な公表データのうち最新のものを取得するには省略します。特定の期間を1つ指定することもできます。

  • version_id任意

    任意の不変な公開バージョン。dataset.published または dataset.revised イベントの resource_version を使います。省略すると現在承認されている指標を読み取ります。

レスポンスフィールド

  • country文字列

    指定された大文字 ISO alpha-3 国コード。

  • period文字列

    返される公式観測期間。

  • year_over_year小数文字列

    前年同月からの変化率。単位はパーセントです。

  • month_over_month小数文字列

    前月からの変化率。単位はパーセントです。

  • year_to_date小数文字列

    前年12月からの変化率。単位はパーセントです。公表元が公表していない場合は省略します。

  • released_on日付

    Narwhal の取得時刻ではなく、公式の公表日。

  • sourceオブジェクト

    任意の source オブジェクトは、統計が配信元経由で届いた場合にだけ現れます。publisher(配信元が示す元の発表機関)と distributor(配信した組織)を含みます。source がある場合、released_on は配信元の公表日であり、元の発表機関の発表日ではありません。発表機関から直接届く系列には source がありません。


リファレンス全文 →
GETインフレ率の履歴/v1/economics/{country}/inflation/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オブジェクト

    配信事業者を通じて受け取った統計の出所情報。最新値を取得する操作を参照してください。

  • 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[].month_over_month小数文字列

    前月からの変化率。単位はパーセントです。

  • observations[].year_to_date小数文字列

    前年12月からの変化率。単位はパーセントです。公表元が公表していない場合は省略します。

  • next_cursor文字列または null

    次のページを読むには、この値を変更せず cursor に渡してください。最終ページでは null です。


リファレンス全文 →

ユースケース

国別のインフレ率を比較する

最新のインフレ率を順位付けし、各発表日も残します。

ガイドを読む →

インフレ調整後の価格を求める

CPI 指数の水準を使って、過去の価格が今ならいくらに当たるかを調べます。

ガイドを読む →

CPI の前年比と前月比

変化率を API から取得するか、指数の水準から計算します。

ガイドを読む →

次の CPI 発表を調べる

次回発表の対象月と予定時刻を読み取ります。

ガイドを読む →

実質金利を計算する

フィッシャー方程式で名目利回りからインフレ分を差し引きます。

ガイドを読む →

発表前にアラートを受け取る

カレンダーフィードや毎日のスクリプトでリマインダーを設定します。

ガイドを読む →

カバレッジ

指標

国

36か国をすべて表示

ソース

  • オーストラリアオーストラリア統計局(ABS)
  • オーストリアStatistics Austria、Eurostat
  • ベルギーStatbel、ベルギー国立銀行、Eurostat
  • カナダカナダ統計局
  • スイススイス連邦統計局(FSO)、Eurostat
  • チリチリ中央銀行(BCCh)、チリ国立統計研究所(INE)
  • コロンビア国家統計行政局(DANE)
  • チェコチェコ統計局(ČSÚ)
  • ドイツドイツ連邦統計局(Destatis)
  • デンマークStatistics Denmark、Eurostat
  • スペインスペイン国立統計研究所(INE)、スペイン税務庁(AEAT)
  • エストニアStatistics Estonia
36 件のソースをすべて表示
  • フィンランドStatistics Finland、フィンランド税関(Tulli)
  • フランス国立統計経済研究所(INSEE)、フランス税関
  • 英国英国国家統計局(ONS)
  • クロアチアクロアチア統計局(CBS)
  • アイルランドCentral Statistics Office (CSO)
  • イタリアイタリア国立統計研究所(Istat)、Eurostat
  • 日本総務省統計局、日本の内閣府、日本税関
  • リトアニアリトアニア国家データ庁
  • ルクセンブルクSTATEC、Eurostat
  • ラトビアラトビア中央統計局(CSB)
  • メキシコ国立統計地理情報院(INEGI)
  • マレーシアマレーシア統計局(DOSM)
  • オランダオランダ統計局(CBS)
  • ノルウェーStatistics Norway(SSB)
  • フィリピンフィリピン統計局(PSA)
  • ポーランドStatistics Poland、Eurostat
  • ポルトガルStatistics Portugal(INE)
  • カタールNational Planning Council (NPC)(Qatar Open Data ポータル経由)
  • サウジアラビア統計総局(GASTAT)
  • シンガポールシンガポール統計局(SingStat)、シンガポール政府のオープンデータ公開資料
  • スロベニアスロベニア共和国統計局(SURS)
  • スウェーデンStatistics Sweden(SCB)
  • 米国労働統計局(BLS)、経済分析局(BEA)、米国国勢調査局
  • パキスタンパキスタン統計局(PBS)

関連 API

経済データAPI

価格、労働、産出、貿易、金利の公式指標。

APIを見る →

経済指標カレンダーAPI

発表スケジュール、ステータス、公開データのバージョン。

APIを見る →

よくある質問

CPIの水準とインフレ率の両方を利用できますか。

はい。ライブの対象範囲には、CPIの指数水準とインフレ率が含まれます。

特定の期間を指定してリクエストできますか。

はい。正確な期間の指定、日付付きの履歴の取得、最新の承認済みの値の照会ができます。

統計はどこから取得していますか。

各国の統計機関が公表する公式統計で、国別に整理されています。