---
title: "Harmonised inflation API Reference | Narwhal API"
description: "1つの国について、最新の調和インフレ率（HICP）として、パーセント表示の年率を取得します。Parameters, examples, errors, freshness, and coverage."
url: "https://narwhalapi.com/ja/docs/api/economics/harmonised-inflation"
---

# 調和インフレ率 API

1つの国について、最新の調和インフレ率（HICP）として、パーセント表示の年率を取得します。

`economics_get_harmonised_inflation` を利用できるのは REST と、 `economics_get_harmonised_inflation` MCPツール。どちらも同じデータ形式を返し、同じクレジットを使用します。

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

REST エンドポイント

```
GET /v1/economics/{country}/harmonised-inflation
```

リクエストの例

```
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/FRA/harmonised-inflation" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
```

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

## パラメータ

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

| 名前 | 必須 | 種別 | 意味 |
| --- | --- | --- | --- |
| `country` | はい | パス · ISO alpha-3 | 対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。 |
| `period` | いいえ | クエリ · YYYY-MM | 受け入れ済みの完全な公表データのうち最新のものを取得するには省略します。特定の期間を1つ指定することもできます。 |
| `series_id` | いいえ | クエリ · UUID | 任意。省略すると、デフォルトの系列である年率を返します。指数水準を読み取るには、指数水準の`series_id`を渡します。`GET /v1/economics/{country}/series?family=harmonised-inflation`で確認できます。`unit`が`index`の系列がそれです。 |

## レスポンス

レスポンスの例

```
{
  "source": {
    "publisher": "Eurostat",
    "distributor": "Eurostat"
  },
  "measure": "year_over_year",
  "seasonal_adjustment": "not_seasonally_adjusted",
  "classification": "COICOP 2018, all items (HICP total)",
  "period": "2026-10",
  "value": "3.7",
  "country": "FRA",
  "series_id": "1b1f2448-2ba6-4523-a6ce-55c488ca15d1",
  "unit": "percent"
}
```

| フィールド | 種別 | 必須 | 意味 |
| --- | --- | --- | --- |
| `source` | オブジェクト | はい | 数値の発行元。`publisher`はその数値を出した統計機関で、`distributor`はNarwhalが読み取る元の機関です。系列ごとに全履歴を通じて出典は1つです。`released_on`はありません。 |
| `measure` | 文字列 | はい | `year_over_year`は前年比の変化率（パーセント）。`level`は指数水準です。 |
| `seasonal_adjustment` | 文字列 | はい | Always `not_seasonally_adjusted`. |
| `classification` | 文字列 | はい | 数値が対象とする物価の集計区分：全品目、COICOP 2018。 |
| `base_period` | 文字列 | いいえ | 指数が100となる年。Present for the index level only. |
| `base_value` | 小数文字列 | いいえ | 基準年の指数値。指数水準にのみ含まれます。 |
| `period` | 文字列 | はい | 返される公式観測期間。 |
| `value` | 小数文字列 | はい | `unit`の数値：パーセント表示の年率（負になることもあります）、または指数水準。 |
| `status` | 文字列 | いいえ | 発行元が示す数値にのみ含まれます：`estimated`、`break_in_series`、`definition_differs`、`break_in_series_and_definition_differs`。それ以外は省略されます。 |
| `release_status` | 文字列 | いいえ | 発行元がその数値を暫定としている場合は`preliminary`。それ以外は省略されます。 |
| `country` | 文字列 | はい | 指定された大文字 ISO alpha-3 国コード。 |
| `series_id` | 文字列 | はい | 数値の元になった系列。同じ系列を再度読み取るには、`series_id`として渡します。 |
| `unit` | 文字列 | はい | 年率は`percent`、指数水準は`index`。 |

## APIエラーとクレジット

- `400 invalid_query`: A query parameter is unknown or repeated, `country` is not three uppercase letters, `series_id` is not a UUID, or `period` is not a month in `YYYY-MM` format. `version_id`, `version` and `as_of` are not accepted on this route.
- `401 invalid_api_key`: Bearerキーがないか拒否されました。
- `402 insufficient_credits`: 残高では呼び出しの料金を支払えません。
- `404 series_not_found`: その国がこのページの対象国一覧にない、`series_id`がその国の系列ではない、または`period`に一致する観測値がありません。一覧にない国には、この指標群は利用できないという詳細が返ります。404は課金されません。
- `429 rate_limit_exceeded`: ネットワークまたはアカウントの短時間枠の上限に達しました。`Retry-After`の後に再試行してください。
- `503 economics_unavailable`: Narwhalは保存されている系列を安全に提供できません。

Only a successful data response costs credit. 参照： [すべてのエラー、ヘッダー、再試行規則](https://narwhalapi.com/ja/docs/errors.md)。

## 鮮度

`period`を省略すると、保存されている最新の観測値を返します。このAPI呼び出しはNarwhalのデータベースを読み取ります。発行元をリアルタイムで呼び出すことはありません。配信元が示す日付は発行元の公表日ではないため、回答に`released_on`はありません。

読む [ソース確認、検証、保存済みリリース、確認失敗の仕組み](https://narwhalapi.com/ja/docs/freshness.md)。

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

10 国

`DNK, ESP, FIN, FRA, IRL, LVA, NLD, PRT, SVN, SWE`

月次の消費者物価調和指数（HICP）。全品目、Eurostat、季節調整なし。各国の`inflation`ルートとは別物で、同じ国でも2つの数値は異なります。デフォルトの系列は前年比の変化率（パーセント）で、負になることもあります。指数水準の基準は`2025=100`です。期間は`YYYY-MM`形式の月です。ほかの国は`404 series_not_found`を返し、課金されません。指数水準を読み取るには、まずその国の系列を一覧します。`GET /v1/economics/{country}/series?family=harmonised-inflation`は各系列を`series_id`、`name`、`unit`（`percent`または`index`）、`is_default`とともに返し、`limit`と`cursor`を付けたリクエストで順にページをたどれます。`unit`が`index`である`series_id`を、最新ルートまたは履歴ルートに渡します。

### List the 系列

リクエストの例

```
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/FRA/series?family=harmonised-inflation" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
```

レスポンスの例

```
{
  "series": [
    {
      "country": "FRA",
      "series_id": "11bc022a-cd6e-4847-8ff8-11dae4e93451",
      "unit": "index",
      "name": "Harmonised index of consumer prices",
      "frequency": "monthly",
      "first_period": "2000-01",
      "last_period": "2026-10",
      "family": "harmonised-inflation",
      "definition": {
        "base_period": "2025",
        "base_value": "100",
        "seasonal_adjustment": "not_seasonally_adjusted",
        "measure": "level",
        "classification": "COICOP 2018, all items (HICP total)"
      }
    },
    {
      "country": "FRA",
      "series_id": "1b1f2448-2ba6-4523-a6ce-55c488ca15d1",
      "unit": "percent",
      "name": "Harmonised inflation, annual rate",
      "is_default": true,
      "frequency": "monthly",
      "first_period": "2000-01",
      "last_period": "2026-10",
      "family": "harmonised-inflation",
      "definition": {
        "measure": "year_over_year",
        "seasonal_adjustment": "not_seasonally_adjusted",
        "annualization": "not_annualized",
        "classification": "COICOP 2018, all items (HICP total)"
      }
    }
  ],
  "next_cursor": null
}
```

日次 FX データの提供先は [為替API](https://narwhalapi.com/ja/api/fx.md)。

戻る： [すべての 経済データ 操作](https://narwhalapi.com/ja/docs/api/economics.md)。

## 無料キーで始めましょう

毎月10ドル分の無料クレジット。カードは不要です。毎月10ドル分の無料クレジット。カードは不要です。

[無料のAPIキーを取得](https://narwhalapi.com/ja/signup)

このページは役に立ちましたか?
