جميع واجهات API

API بيانات سوق العمل

اقرأ بيانات سوق العمل الرسمية من بطالة ومشاركة في القوى العاملة حسب الدولة. استخدم REST أو MCP لجلب آخر قيمة معتمدة أو فترة محددة أو تاريخ مؤرخ.

احصل على مفتاح API مجاني
اقرأ التوثيق ‏←
متاح99.94% uptime, last 30 أيام378 ms زمن الاستجابة المعتاد

الطلب الأول

احصل على أحدث قيمة

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/unemployment?period=2026-07" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

نقاط النهاية

GETالبطالة/v1/economics/{country}/unemployment

استرجع معدل البطالة الرسمي لفترة رصد واحدة.

المعلمات

  • countryمطلوب

    رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية.

  • periodاختياري

    لا تُرسله للحصول على أحدث إصدار مكتمل مقبول، أو حدّد فترة واحدة بعينها.

  • version_idاختياري

    إصدار نشر اختياري غير قابل للتغيير. استخدم resource_version من حدث dataset.published أو dataset.revised، واتركه فارغًا لقراءة المؤشر المعتمد الحالي.

حقول الاستجابة

  • countryسلسلة نصية

    رمز الدولة المطلوب بالأحرف الكبيرة وفق ISO alpha-3.

  • periodسلسلة نصية

    فترة الرصد الرسمية المعادة.

  • rateسلسلة نصية لعدد عشري

    المعدل المنشور، بالنسبة المئوية، من 0 إلى 100 شاملًا.

  • released_onالتاريخ

    تاريخ النشر الرسمي، وليس وقت استرجاع Narwhal.

  • sourceكائن

    يظهر الكائن source الاختياري فقط عندما يصل الإحصاء عبر موزّع. ويتضمن publisher (الناشر الأصلي الذي ذكره الموزّع) وdistributor (الجهة الموزِّعة). عند وجود source يكون released_on تاريخ نشر الموزّع لا تاريخ إصدار الناشر الأصلي. السلاسل الواردة مباشرة من الناشر لا تتضمن source.

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

استرجع السلسلة الزمنية الحالية المقبولة للبطالة في دولة واحدة.

المعلمات

  • countryمطلوب

    رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية.

  • startاختياري

    أول فترة رصد، وهي مشمولة في النتائج.

  • endاختياري

    آخر فترة رصد، وهي مشمولة في النتائج.

  • limitاختياري

    الحد الأقصى لعدد الفترات المُعادة. القيمة الافتراضية 100. قد تحتوي الصفحة على فترات أقل؛ اتبع next_cursor.

  • cursorاختياري

    قيمة next_cursor من الصفحة السابقة.

  • versionاختياري

    يقبل first_reported فقط: يعيد أول قيمة مخزَّنة لكل فترة مع first_reported_at. لا يمكن دمجه مع as_of.

  • as_ofاختياري

    يعيد السلسلة كما نُشرت حتى نهاية يوم UTC المحدد. لا يمكن دمجه مع version.

حقول الاستجابة

  • countryسلسلة نصية

    رمز البلد المطلوب بأحرف كبيرة وفق ISO alpha-3. يُعاد مرة واحدة لكل صفحة، وليس مع كل مشاهدة.

  • startسلسلة نصية

    يظهر فقط عندما ينقل Narwhal قيمة start المطلوبة إلى فترة لاحقة. لا تُعاد الفترات الأقدم.

  • as_ofطابع زمني وفق RFC 3339

    وقت آخر تحديث أجراه المصدر لأحدث مشاهدة في هذه الصفحة، بدقة الثواني الكاملة، وفق UTC.

  • sourceكائن

    معلومات منشأ الإحصاء الوارد عبر موزّع؛ راجع عملية أحدث قيمة.

  • observationsمصفوفة

    المشاهدات المعتمدة من الأقدم إلى الأحدث، مشاهدة واحدة لكل فترة. تُحذف قيم المصدر المفقودة ولا تُملأ أبدًا. قد تحتوي الصفحة على مشاهدات أقل من limit؛ اتبع next_cursor حتى تصبح قيمته null.

  • observations[].periodسلسلة نصية

    الشهر أو الربع الرسمي الذي تمثله القراءة.

  • observations[].first_reported_atطابع زمني وفق RFC 3339

    لا يظهر إلا مع version=first_reported. يسجل هذا الطابع الزمني بتوقيت UTC متى خزّن Narwhal الفترة لأول مرة (وآخر وقت إذا خُزّنت مقاييسها منفصلة). أما الفترات التي صدرت قبل بدء الالتقاط فتعرض أول التقاط لدى Narwhal.

  • observations[].rateسلسلة نصية لعدد عشري

    المعدل المنشور، بالنسبة المئوية.

  • next_cursorسلسلة نصية أو null

    مرّر هذه القيمة دون تغيير في cursor لقراءة الصفحة التالية؛ وتكون null في الصفحة الأخيرة.

المرجع الكامل ‏←
GETالمشاركة في القوى العاملة/v1/economics/{country}/labour-force-participation

استرجع معدل المشاركة الرسمي في القوى العاملة لفترة رصد واحدة.

المعلمات

  • countryمطلوب

    رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية.

  • periodاختياري

    لا تُرسله للحصول على أحدث إصدار مكتمل مقبول، أو حدّد فترة واحدة بعينها.

  • version_idاختياري

    إصدار نشر اختياري غير قابل للتغيير. استخدم resource_version من حدث dataset.published أو dataset.revised، واتركه فارغًا لقراءة المؤشر المعتمد الحالي.

حقول الاستجابة

  • countryسلسلة نصية

    رمز الدولة المطلوب بالأحرف الكبيرة وفق ISO alpha-3.

  • periodسلسلة نصية

    فترة الرصد الرسمية المعادة.

  • rateسلسلة نصية لعدد عشري

    المعدل المنشور، بالنسبة المئوية، من 0 إلى 100 شاملًا.

  • released_onالتاريخ

    تاريخ النشر الرسمي، وليس وقت استرجاع Narwhal.

  • sourceكائن

    يظهر الكائن source الاختياري فقط عندما يصل الإحصاء عبر موزّع. ويتضمن publisher (الناشر الأصلي الذي ذكره الموزّع) وdistributor (الجهة الموزِّعة). عند وجود source يكون released_on تاريخ نشر الموزّع لا تاريخ إصدار الناشر الأصلي. السلاسل الواردة مباشرة من الناشر لا تتضمن source.

المرجع الكامل ‏←
GETسجل المشاركة في القوى العاملة/v1/economics/{country}/labour-force-participation/observations

استرجع السلسلة الزمنية المعتمدة حاليًا لبيانات المشاركة في القوى العاملة لدولة واحدة.

المعلمات

  • countryمطلوب

    رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية.

  • startاختياري

    أول فترة رصد، وهي مشمولة في النتائج.

  • endاختياري

    آخر فترة رصد، وهي مشمولة في النتائج.

  • limitاختياري

    الحد الأقصى لعدد الفترات المُعادة. القيمة الافتراضية 100. قد تحتوي الصفحة على فترات أقل؛ اتبع next_cursor.

  • cursorاختياري

    قيمة next_cursor من الصفحة السابقة.

  • versionاختياري

    يقبل first_reported فقط: يعيد أول قيمة مخزَّنة لكل فترة مع first_reported_at. لا يمكن دمجه مع as_of.

  • as_ofاختياري

    يعيد السلسلة كما نُشرت حتى نهاية يوم UTC المحدد. لا يمكن دمجه مع version.

حقول الاستجابة

  • countryسلسلة نصية

    رمز البلد المطلوب بأحرف كبيرة وفق ISO alpha-3. يُعاد مرة واحدة لكل صفحة، وليس مع كل مشاهدة.

  • startسلسلة نصية

    يظهر فقط عندما ينقل Narwhal قيمة start المطلوبة إلى فترة لاحقة. لا تُعاد الفترات الأقدم.

  • as_ofطابع زمني وفق RFC 3339

    وقت آخر تحديث أجراه المصدر لأحدث مشاهدة في هذه الصفحة، بدقة الثواني الكاملة، وفق UTC.

  • sourceكائن

    معلومات منشأ الإحصاء الوارد عبر موزّع؛ راجع عملية أحدث قيمة.

  • observationsمصفوفة

    المشاهدات المعتمدة من الأقدم إلى الأحدث، مشاهدة واحدة لكل فترة. تُحذف قيم المصدر المفقودة ولا تُملأ أبدًا. قد تحتوي الصفحة على مشاهدات أقل من limit؛ اتبع next_cursor حتى تصبح قيمته null.

  • observations[].periodسلسلة نصية

    الشهر أو الربع الرسمي الذي تمثله القراءة.

  • observations[].first_reported_atطابع زمني وفق RFC 3339

    لا يظهر إلا مع version=first_reported. يسجل هذا الطابع الزمني بتوقيت UTC متى خزّن Narwhal الفترة لأول مرة (وآخر وقت إذا خُزّنت مقاييسها منفصلة). أما الفترات التي صدرت قبل بدء الالتقاط فتعرض أول التقاط لدى Narwhal.

  • observations[].rateسلسلة نصية لعدد عشري

    المعدل المنشور، بالنسبة المئوية.

  • next_cursorسلسلة نصية أو null

    مرّر هذه القيمة دون تغيير في cursor لقراءة الصفحة التالية؛ وتكون null في الصفحة الأخيرة.

المرجع الكامل ‏←

حالات الاستخدام

أنشئ تقويمًا اقتصاديًا عبر API التقويم الاقتصادي

اعرض أوقات الإصدار بتوقيت UTC للدول والتواريخ التي تختارها.

اقرأ الدليل ‏←

احصل على تنبيه قبل الإصدار

اضبط تذكيرًا عبر خلاصة تقويم أو سكربت يومي.

اقرأ الدليل ‏←

ملء السجل التاريخي

نزّل سلسلة كاملة صفحة بصفحة واستأنف إذا توقف التنزيل.

اقرأ الدليل ‏←

التغطية

المؤشرات

الدول

عرض كل الدول (35)

المصادر

  • أسترالياالمكتب الأسترالي للإحصاء (ABS)
  • النمساإحصاءات النمسا، يوروستات
  • بلجيكاStatbel، البنك الوطني البلجيكي، يوروستات
  • كنداهيئة الإحصاء الكندية
  • سويسراالمكتب الفدرالي السويسري للإحصاء (FSO)، يوروستات
  • تشيليالبنك المركزي التشيلي (BCCh)، المعهد الوطني للإحصاء في تشيلي (INE)
  • كولومبياالإدارة الوطنية الإدارية للإحصاء (DANE)
  • تشيكياالمكتب الإحصائي التشيكي (ČSÚ)
  • ألمانياالمكتب الاتحادي للإحصاء في ألمانيا (Destatis)
  • الدنماركإحصاءات الدنمارك، يوروستات
  • إسبانياالمعهد الوطني للإحصاء في إسبانيا (INE)، وكالة الضرائب الإسبانية (AEAT)
  • إستونياإحصاءات إستونيا
عرض كل 35 مصدرًا
  • فنلنداإحصاءات فنلندا، الجمارك الفنلندية (Tulli)
  • فرنساالمعهد الوطني للإحصاء والدراسات الاقتصادية (INSEE)، الجمارك الفرنسية
  • المملكة المتحدةمكتب الإحصاءات الوطنية (ONS)
  • كرواتياالمكتب الكرواتي للإحصاء (CBS)
  • أيرلندامكتب الإحصاء المركزي (CSO)
  • إيطالياالمعهد الوطني الإيطالي للإحصاء (Istat)، يوروستات
  • اليابانمكتب الإحصاء الياباني، مكتب مجلس الوزراء الياباني، الجمارك اليابانية
  • ليتوانياوكالة بيانات الدولة في ليتوانيا
  • لوكسمبورغSTATEC، يوروستات
  • لاتفياالمكتب المركزي للإحصاء في لاتفيا (CSB)
  • المكسيكالمعهد الوطني للإحصاء والجغرافيا والمعلوماتية (INEGI)
  • ماليزيادائرة الإحصاءات الماليزية (DOSM)
  • هولنداهيئة الإحصاء الهولندية (CBS)
  • النرويجإحصاءات النرويج (SSB)
  • نيوزيلنداإحصاءات نيوزيلندا
  • الفلبينهيئة الإحصاء الفلبينية (PSA)
  • بولنداإحصاءات بولندا، يوروستات
  • البرتغالإحصاءات البرتغال (INE)
  • المملكة العربية السعوديةالهيئة العامة للإحصاء (GASTAT)
  • سنغافورةدائرة الإحصاء السنغافورية (SingStat)، منشورات البيانات الحكومية السنغافورية المفتوحة
  • سلوفينياالمكتب الإحصائي لجمهورية سلوفينيا (SURS)
  • السويدإحصاءات السويد (SCB)
  • الولايات المتحدةمكتب إحصاءات العمل (BLS)، مكتب التحليل الاقتصادي (BEA)، مكتب الإحصاء الأمريكي

واجهات API ذات صلة

واجهة API للبيانات الاقتصادية

مؤشرات رسمية للأسعار والعمل والإنتاج والتجارة والمعدلات.

استكشف API ‏←

واجهة API للتقويم الاقتصادي

جداول الإصدارات وحالتها ونسخ النشر.

استكشف API ‏←

الأسئلة الشائعة

أي مقاييس العمل متاحة مباشرة؟

معدلات البطالة والمشاركة في القوى العاملة متاحة مباشرة اليوم.

هل يمكنني جلب بيانات العمل التاريخية؟

نعم. السجل التاريخي المؤرخ وطلبات الفترة المحددة متاحة إلى جانب أحدث قيمة معتمدة.

هل يستخدم REST وMCP مفتاح API نفسه؟

نعم. يعمل مفتاح API نفسه مع REST وMCP.