جميع واجهات API

واجهة البطالة API

معدلات البطالة الرسمية في عشر دول.

الطلب الأول

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: رمز دولة واحد مدعوم بأحرف كبيرة: AUS وCAN وDEU وFRA وGBR وJPN وMYS وNLD وSGP وUSA.
period: اتركه لأحدث إصدار مكتمل مقبول، أو مرر فترة واحدة دقيقة.

MCP · economics_get_unemployment

مرجع API →

GETسجل البطالة التاريخي/v1/economics/{country}/unemployment/observations

country: رمز دولة واحد مدعوم بأحرف كبيرة: 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"
}