すべてのドキュメントを閲覧

生産者物価 API

1つの国について、Eurostatの最新の月次生産者物価指数を取得します。

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

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

REST エンドポイント
GET /v1/economics/{country}/producer-prices
リクエストの例
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/NOR/producer-prices" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

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

パラメータ

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

名前必須種別意味
countryはいパス · ISO alpha-3対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。
periodいいえクエリ · YYYY-MM受け入れ済みの完全な公表データのうち最新のものを取得するには省略します。特定の期間を1つ指定することもできます。
series_idいいえクエリ · 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)",
  "period": "2026-10",
  "value": "160.7",
  "country": "NOR",
  "series_id": "d942a081-f7fa-4ee5-b1c7-4e3834249414",
  "unit": "index"
}
フィールド種別必須意味
sourceオブジェクトはい数値の発行元。publisherはその数値を出した統計機関で、distributorはNarwhalが読み取る元の機関です。系列ごとに全履歴を通じて出典は1つです。released_onはありません。
seasonal_adjustment文字列はいAlways not_seasonally_adjusted.
base_period文字列はいThe year the index is 100 in. 2021 here.
base_value小数文字列はい基準年の指数値。ここではすべての系列で100です。
market文字列はい常にdomestic:輸出ではなく、国内市場で販売された生産高。
producer_scope文字列はい指数が対象とする産業:NACE Rev. 2の区分BからE36。建設、下水道、廃棄物管理、環境修復を除く工業です。
period文字列はい返される公式観測期間。
value小数文字列はい指数水準。基準はbase_periodとbase_valueにあります。水準であり、成長率ではありません。
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文字列はいAlways 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. 参照: すべてのエラー、ヘッダー、再試行規則。

鮮度

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

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

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

8 国

BGR, CZE, DNK, ESP, FRA, LUX, NOR, SVN

国内市場向け工業(NACE Rev. 2の区分BからE36)の月次指数水準。2021=100、季節調整なし。出典はEurostatです。値は水準であり、成長率ではありません。期間はYYYY-MM形式の月です。ほかの国は404 not_foundを返し、課金されません。

日次 FX データの提供先は 為替API。

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

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