جميع واجهات API

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

مصدر واحد لبيانات مؤشر أسعار المستهلك والتضخم وسوق العمل والناتج المحلي الإجمالي والتجارة من وكالات الإحصاء الرسمية.

الطلب الأول

دليل البدء السريع ‏←

استرجع مؤشر أسعار المستهلك العام لدولة واحدة وشهر واحد.

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/cpi?period=2026-07" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
استجابة نموذجية استجابة توضيحية · ليست طلبًا مباشرًا
{
  "country": "USA",
  "period": "2026-07",
  "value": "333.918",
  "index_base": "1982-84=100",
  "released_on": "2026-08-12"
}

نقاط النهاية

GETمؤشر أسعار المستهلك/v1/economics/{country}/cpi

استرجع مؤشر أسعار المستهلك العام لدولة واحدة وشهر واحد.

country
رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية.
period
لا تُرسله للحصول على أحدث إصدار مكتمل مقبول، أو حدّد فترة واحدة بعينها.
version_id
نسخة نشر غير قابلة للتغيير واختيارية. استخدم `resource_version` من حدث `dataset.published` أو `dataset.revised`؛ واحذفه لقراءة المؤشر المعتمد حاليًا.

MCP · economics_get_cpi

مرجع API ‏←السجل ‏←
GETالتضخم/v1/economics/{country}/inflation

استرجع التضخم على أساس سنوي وشهري ومنذ بداية السنة لشهر واحد.

country
رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية.
period
لا تُرسله للحصول على أحدث إصدار مكتمل مقبول، أو حدّد فترة واحدة بعينها.
version_id
نسخة نشر غير قابلة للتغيير واختيارية. استخدم `resource_version` من حدث `dataset.published` أو `dataset.revised`؛ واحذفه لقراءة المؤشر المعتمد حاليًا.

MCP · economics_get_inflation

مرجع API ‏←السجل ‏←
GETالبطالة/v1/economics/{country}/unemployment

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

country
رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية.
period
لا تُرسله للحصول على أحدث إصدار مكتمل مقبول، أو حدّد فترة واحدة بعينها.
version_id
نسخة نشر غير قابلة للتغيير واختيارية. استخدم `resource_version` من حدث `dataset.published` أو `dataset.revised`؛ واحذفه لقراءة المؤشر المعتمد حاليًا.

MCP · economics_get_unemployment

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

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

country
رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية.
period
لا تُرسله للحصول على أحدث إصدار مكتمل مقبول، أو حدّد فترة واحدة بعينها.
version_id
نسخة نشر غير قابلة للتغيير واختيارية. استخدم `resource_version` من حدث `dataset.published` أو `dataset.revised`؛ واحذفه لقراءة المؤشر المعتمد حاليًا.

MCP · economics_get_labour_force_participation

مرجع API ‏←السجل ‏←
GETالناتج المحلي الإجمالي/v1/economics/{country}/gdp

استرجع GDP الوطني لفصل واحد، بالأسعار الجارية دائمًا.

country
رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية.
period
لا تُرسله للحصول على أحدث إصدار مكتمل مقبول، أو حدّد فترة واحدة بعينها.
version_id
نسخة نشر غير قابلة للتغيير واختيارية. استخدم `resource_version` من حدث `dataset.published` أو `dataset.revised`؛ واحذفه لقراءة المؤشر المعتمد حاليًا.

MCP · economics_get_gdp

مرجع API ‏←السجل ‏←
GETنمو الناتج المحلي الإجمالي/v1/economics/{country}/gdp-growth

استرجع نمو GDP الحقيقي الرسمي لفصل واحد، مقاسًا بالأسعار الثابتة ومعبّرًا عنه بالنسبة المئوية.

country
رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية.
period
لا تُرسله للحصول على أحدث إصدار مكتمل مقبول، أو حدّد فترة واحدة بعينها.
version_id
نسخة نشر غير قابلة للتغيير واختيارية. استخدم `resource_version` من حدث `dataset.published` أو `dataset.revised`؛ واحذفه لقراءة المؤشر المعتمد حاليًا.

MCP · economics_get_gdp_growth

مرجع API ‏←السجل ‏←
GETتجارة السلع/v1/economics/{country}/trade

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

country
رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية.
period
لا تُرسله للحصول على أحدث إصدار مكتمل مقبول، أو حدّد فترة واحدة بعينها.
version_id
نسخة نشر غير قابلة للتغيير واختيارية. استخدم `resource_version` من حدث `dataset.published` أو `dataset.revised`؛ واحذفه لقراءة المؤشر المعتمد حاليًا.

MCP · economics_get_trade

مرجع API ‏←السجل ‏←

المصادر والمنهجية

فترات محددة بوضوح

تتضمن كل استجابة فترة الرصد وتاريخ الإصدار الرسمي.

REST وMCP

تشترك REST وMCP في المخططات والحصة عبر جميع العمليات المتاحة.

التغطية

عرض التغطية ‏←

استكشف البيانات الاقتصادية الحالية والتاريخية من ناشرين وطنيين رسميين. تختلف التغطية حسب العملية والدولة.

المؤشرات

مؤشرات الأسعار

مؤشر أسعار المستهلكالتضخم

سوق العمل

البطالةالمشاركة في القوى العاملة

الإنتاج

GDPنمو الناتج المحلي الإجمالي

التجارة

الميزان التجاريالصادراتالواردات

أسعار الفائدة

منحنيات العائد (الإنجليزية)

الدول

أسترالياالنمسابلجيكاكنداتشيليكولومبياتشيكياألمانياالدنماركإسبانياإستونيافنلندافرنساالمملكة المتحدةكرواتياأيرلنداإيطاليااليابانليتوانيالوكسمبورغلاتفياالمكسيكماليزياهولنداالنرويجنيوزيلنداباكستانالفلبينبولنداالبرتغالقطرالمملكة العربية السعوديةسنغافورةسلوفينياالسويدالولايات المتحدة

استكشف الصفحات ذات الصلة

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

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

استكشف API ‏←

Yield curve API: the US, UK, Germany, Japan, and Canada

منحنيات عائد السندات الحكومية في الولايات المتحدة والمملكة المتحدة وألمانيا واليابان وكندا. استرجع بيانات تاريخ محدد أو سجلًا مقسمًا إلى صفحات عبر REST وMCP.

استكشف API ‏← (الإنجليزية)

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

ما الدول المدعومة؟

راجع جدول التغطية لمعرفة الدول التي تُنشر بياناتها. تختلف المؤشرات والفترات التاريخية المتاحة حسب الدولة.

هل تتضمن API بيانات اقتصادية تاريخية؟

نعم. لكل عملية من عمليات أحدث الإصدارات السبع مسار observations مقابل للسلسلة التاريخية المعتمدة حاليًا.

من أين تأتي البيانات الاقتصادية؟

يأتي كل تدفق بيانات متاح من مكتب إحصاء حكومي أو جهة نشر وطنية رسمية أخرى مذكورة في مصفوفة التغطية.

ما سرعة توفر الإصدار الجديد؟

ينشر Narwhal الإصدار بعد اجتيازه التحقق. ولا تَعِد النسخة التجريبية العامة بمدة ثابتة بين صدوره لدى المصدر ونشره.

أجرِ أول طلب لك

احصل على مفتاح API مجاني ‏←