経済カレンダーを作成する
選んだ国と日付のリリース時刻を UTC で一覧します。
ガイドを読む →国別の公式な失業率と労働参加率を含む労働力人口データを読み取れます。RESTまたはMCPで、受理済みの最新値、指定期間の値、日付付きの履歴を取得できます。
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/USA/unemployment?period=2026-07" \
--header "Authorization: Bearer $NARWHAL_API_KEY"/v1/economics/{country}/unemployment1つの観測期間について、公式の失業率を取得します。
country必須対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。
period任意受け入れ済みの完全な公表データのうち最新のものを取得するには省略します。特定の期間を1つ指定することもできます。
version_id任意任意の不変な公開バージョン。dataset.published または dataset.revised イベントの resource_version を使います。省略すると現在承認されている指標を読み取ります。
country文字列指定された大文字 ISO alpha-3 国コード。
period文字列返される公式観測期間。
rate小数文字列公表された率。単位はパーセントで、範囲は 0 以上 100 以下です。
released_on日付Narwhal の取得時刻ではなく、公式の公表日。
sourceオブジェクト任意の source オブジェクトは、統計が配信元経由で届いた場合にだけ現れます。publisher(配信元が示す元の発表機関)と distributor(配信した組織)を含みます。source がある場合、released_on は配信元の公表日であり、元の発表機関の発表日ではありません。発表機関から直接届く系列には source がありません。
/v1/economics/{country}/unemployment/observations1つの国について、現在受け入れられている失業率の時系列を取得します。
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[].rate小数文字列公表された率。単位はパーセントです。
next_cursor文字列または null次のページを読むには、この値を変更せず cursor に渡してください。最終ページでは null です。
/v1/economics/{country}/labour-force-participation1つの観測期間について、公式の労働力率を取得します。
country必須対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。
period任意受け入れ済みの完全な公表データのうち最新のものを取得するには省略します。特定の期間を1つ指定することもできます。
version_id任意任意の不変な公開バージョン。dataset.published または dataset.revised イベントの resource_version を使います。省略すると現在承認されている指標を読み取ります。
country文字列指定された大文字 ISO alpha-3 国コード。
period文字列返される公式観測期間。
rate小数文字列公表された率。単位はパーセントで、範囲は 0 以上 100 以下です。
released_on日付Narwhal の取得時刻ではなく、公式の公表日。
sourceオブジェクト任意の source オブジェクトは、統計が配信元経由で届いた場合にだけ現れます。publisher(配信元が示す元の発表機関)と distributor(配信した組織)を含みます。source がある場合、released_on は配信元の公表日であり、元の発表機関の発表日ではありません。発表機関から直接届く系列には source がありません。
/v1/economics/{country}/labour-force-participation/observations1つの国について、現在受け入れられている労働力率の時系列を取得します。
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[].rate小数文字列公表された率。単位はパーセントです。
next_cursor文字列または null次のページを読むには、この値を変更せず cursor に渡してください。最終ページでは null です。
失業率と労働力率は、現在ライブで提供しています。
はい。日付付きの履歴と正確な期間の指定を、最新の承認済みの値とあわせて利用できます。
はい。同じAPIキーが、RESTとMCPの両方で使えます。
12か月間、毎月10ドル分の無料クレジット。カードは不要です。毎月10ドル分の無料クレジット。カードは不要です。