すべてのAPI

失業率 API

10か国の公式失業率。

初回リクエスト

クイックスタート
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/unemployment?period=2026-07" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
レスポンスの例 説明用レスポンス · ライブリクエストではありません
{
  "country": "USA",
  "period": "2026-07",
  "rate": "4.1",
  "unit": "percent",
  "released_on": "2026-08-07"
}

エンドポイント

GET失業率/v1/economics/{country}/unemployment
country
サポート対象の大文字国コードを1つ:AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USA。
period
最新の受け入れ済み完全リリースの場合は省略し、特定の期間を1つ指定することもできます。

MCP · economics_get_unemployment

APIリファレンス
GET失業率の履歴/v1/economics/{country}/unemployment/observations
country
サポート対象の大文字国コードを1つ:AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USA。
start
最初の観測期間(その期間を含む)。
end
最後の観測期間(その期間を含む)。
limit
返す観測値の最大数。デフォルトは100です。
cursor
前のページの next_cursor。

MCP · economics_get_unemployment_history

APIリファレンス

履歴

cURL
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/unemployment/observations?start=2026-07&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
レスポンスの例 説明用レスポンス · ライブリクエストではありません
{
  "observations": [
    {
      "country": "USA",
      "measure": "unemployment",
      "value": "4.1",
      "unit": "PCT",
      "transformation": "",
      "period": "2026-07"
    }
  ],
  "next_cursor": null,
  "as_of": "2026-08-29T16:00:00Z"
}

ソースと方法論

一次ソース

稼働中のすべてのストリームは、国の公式発行元から取得します。

方法論を読む

明示的な期間

最新の受け入れ済み完全リリースの場合は省略し、特定の期間を1つ指定することもできます。

REST と MCP

1つのAPIキーでRESTまたはMCPを通じて最新・過去のデータにアクセスできます。

よくある質問

レスポンスには何が含まれますか?

1つの観測期間について、公式の失業率を取得します。

どの期間を指定できますか?

YYYY、YYYY-MM、または YYYY-QN

どの範囲のデータを取得できますか?

観測頻度は各国の公式リリースに従い、AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USA では月次または四半期となる場合があります。

最初のリクエストを実行

無料 API キーを取得