生産者物価の履歴データ API
1つの国について、月次の生産者物価指数を古い順に取得します。
economics_ を利用できるのは REST と、 economics_ MCPツール。どちらも同じデータ形式を返し、同じクレジットを使用します。
エンドポイントとリクエスト
GET /v1/economics/{country}/producer-prices/observationscurl --request GET \
--url "https://api.narwhalapi.com/v1/economics/NOR/producer-prices/observations?start=2026-01&limit=2" \
--header "Authorization: Bearer $NARWHAL_API_KEY"MCP で使用するツールは economics_ です。以下の対応する引数を指定します。
パラメータ
この操作で受け付ける期間形式: YYYY-MM。
| 名前 | 必須 | 種別 | 意味 |
|---|---|---|---|
country | はい | パス · ISO alpha-3 | 対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。 |
start | いいえ | クエリ · YYYY-MM | 最初の観測期間(その期間を含む)。 |
end | いいえ | クエリ · YYYY-MM | 最後の観測期間(その期間を含む)。 |
limit | いいえ | クエリ · 整数、1~1000 | 返す期間数の上限。デフォルトは 100 です。1ページの期間数がこれより少ない場合もあるため、next_cursor をたどってください。 |
cursor | いいえ | クエリ · 不透明な文字列 | 前のページの next_cursor。 |
series_ | いいえ | クエリ · UUID | 任意。以前の回答から取得した1つの系列の`series_id`。省略すると、その国のデフォルトの系列を読み取ります。 |
レスポンス
{
"source": {
"publisher": "Eurostat",
"distributor": "Eurostat"
},
"seasonal_adjustment": "not_seasonally_adjusted",
"base_period": "2021",
"base_value": "100",
"market": "domestic",
"producer_scope": "NACE Rev. 2 B-E36: Industry (except construction, sewerage, waste management and remediation activities)",
"country": "NOR",
"series_id": "d942a081-f7fa-4ee5-b1c7-4e3834249414",
"unit": "index",
"observations": [
{
"period": "2026-01",
"value": "148.7"
},
{
"period": "2026-02",
"value": "149.8"
}
],
"next_cursor": "eyJhZnRlciI6IjIwMjYtMDIi…"
}履歴の例はlimit=2を指定しているため、2行です。ここではnext_を短くしています。実際のものはもっと長い不透明な文字列です。
| フィールド | 種別 | 必須 | 意味 |
|---|---|---|---|
source | オブジェクト | はい | 数値の発行元。publisherはその数値を出した統計機関で、distributorはNarwhalが読み取る元の機関です。系列ごとに全履歴を通じて出典は1つです。released_はありません。 |
seasonal_ | 文字列 | はい | Always not_. |
base_ | 文字列 | はい | The year the index is 100 in. 2021 here. |
base_ | 小数文字列 | はい | 基準年の指数値。ここではすべての系列で100です。 |
market | 文字列 | はい | 常にdomestic:輸出ではなく、国内市場で販売された生産高。 |
producer_ | 文字列 | はい | 指数が対象とする産業:NACE Rev. 2の区分BからE36。建設、下水道、廃棄物管理、環境修復を除く工業です。 |
country | 文字列 | はい | 指定された大文字 ISO alpha-3 国コード。 |
series_ | 文字列 | はい | 数値の元になった系列。同じ系列を再度読み取るには、series_として渡します。 |
unit | 文字列 | はい | Always index. |
observations | 配列 | はい | 期間ごとに1件、古い順の観測値。1ページの件数がlimitより少ないことがあります。next_がnullになるまで辿ってください。 |
observations[].period | 文字列 | はい | 観測値が表す公式の月、四半期、または年。 |
observations[].value | 小数文字列 | はい | 指数水準。基準はbase_とbase_にあります。水準であり、成長率ではありません。 |
observations[].status | 文字列 | いいえ | 発行元が示す数値にのみ含まれます:estimated、break_、definition_、break_。それ以外は省略されます。 |
observations[].release_ | 文字列 | いいえ | 発行元がその数値を暫定としている場合はpreliminary。それ以外は省略されます。 |
next_ | 文字列または null | はい | これを変更せずにcursorとして渡すと、次のページを読み取れます。最後のページではnullです。 |
APIエラーとクレジット
400 invalid_: A query parameter is unknown or repeated,query countryis not three uppercase letters,series_is not a UUID,id startorendis not a month inYYYY-MMformat,startandenddiffer in format orstartis afterend, orlimitis outside 1 to 1000.version_,id versionandas_are not accepted on this route.of 400 invalid_: カーソルの形式が不正か、別のフィルター用に発行されたものです。cursor 409 snapshot_: カーソルは24時間以上前のもので、有効期限が切れています。unavailable cursorなしでやり直してください。401 invalid_: Bearerキーがないか拒否されました。api_ key 402 insufficient_: 残高では呼び出しの料金を支払えません。credits 404 series_: その国がこのページの対象国一覧にない、not_ found series_がその国の系列ではない、または範囲内に観測値がありません。一覧にない国には、この指標群は利用できないという詳細が返ります。404は課金されません。id 429 rate_: ネットワークまたはアカウントの短時間枠の上限に達しました。limit_ exceeded Retry-Afterの後に再試行してください。503 economics_: Narwhalは保存されている系列を安全に提供できません。unavailable
Only a successful data response costs credit. 参照: すべてのエラー、ヘッダー、再試行規則。
鮮度
このルートはNarwhalが現在保存している系列を古い順に返します。startを指定しない場合は保存されている最も古い期間から始まるため、最近の期間を読むにはstartを指定してください。as_やversionは受け取らないため、過去の時点のデータは読み取れません。Narwhalは欠損した観測値を補完せず、省略します。
現在の公開ベータ版カバレッジ
8 国
BGR, CZE, DNK, ESP, FRA, LUX, NOR, SVN
国内市場向け工業(NACE Rev. 2の区分BからE36)の月次指数水準。2021=100、季節調整なし。出典はEurostatです。値は水準であり、成長率ではありません。期間はYYYY-MM形式の月です。ほかの国は404 not_を返し、課金されません。
日次 FX データの提供先は 為替API。
戻る: すべての 経済データ 操作。
無料キーで始めましょう
毎月10ドル分の無料クレジット。カードは不要です。毎月10ドル分の無料クレジット。カードは不要です。
このページは役に立ちましたか?