قارن التضخم بين الدول
رتّب أحدث معدلات التضخم مع الاحتفاظ بتاريخ كل إصدار.
اقرأ الدليل ←جميع واجهات API
API التضخم والأسعار
استعلم عن بيانات API التضخم الرسمية ومؤشر أسعار المستهلك حسب الدولة عبر REST أو MCP. احصل على آخر قيمة معتمدة أو فترة محددة أو تاريخ مؤرخ.
الطلب الأول
احصل على أحدث قيمة
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/USA/cpi?period=2026-07" \
--header "Authorization: Bearer $NARWHAL_API_KEY"نقاط النهاية
GETمؤشر أسعار المستهلك/v1/economics/{country}/cpi
استرجع مؤشر أسعار المستهلك العام لدولة واحدة وشهر واحد.
المعلمات
countryمطلوبرمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية.
periodاختياريلا تُرسله للحصول على أحدث إصدار مكتمل مقبول، أو حدّد فترة واحدة بعينها.
version_idاختياريإصدار نشر اختياري غير قابل للتغيير. استخدم resource_version من حدث dataset.published أو dataset.revised، واتركه فارغًا لقراءة المؤشر المعتمد الحالي.
حقول الاستجابة
countryسلسلة نصيةرمز الدولة المطلوب بالأحرف الكبيرة وفق ISO alpha-3.
periodسلسلة نصيةفترة الرصد الرسمية المعادة.
valueسلسلة نصية لعدد عشري موجبمستوى المؤشر العام.
index_baseسلسلة نصيةفترة أساس المؤشر وقيمته الأساسية، مثل 1982-84=100.
released_onالتاريختاريخ النشر الرسمي، وليس وقت استرجاع Narwhal.
sourceكائنيظهر الكائن source الاختياري فقط عندما يصل الإحصاء عبر موزّع. ويتضمن publisher (الناشر الأصلي الذي ذكره الموزّع) وdistributor (الجهة الموزِّعة). عند وجود source يكون released_on تاريخ نشر الموزّع لا تاريخ إصدار الناشر الأصلي. السلاسل الواردة مباشرة من الناشر لا تتضمن source.
المرجع الكامل ←
GETسجل مؤشر أسعار المستهلك/v1/economics/{country}/cpi/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كائنمعلومات منشأ الإحصاء الوارد عبر موزّع؛ راجع عملية أحدث قيمة.
index_baseسلسلة نصيةفترة أساس المؤشر وقيمته الأساسية، مثل 1982-84=100. لا تضم الصفحة بيانات ذات أساسين مختلفين.
observationsمصفوفةالمشاهدات المعتمدة من الأقدم إلى الأحدث، مشاهدة واحدة لكل فترة. تُحذف قيم المصدر المفقودة ولا تُملأ أبدًا. قد تحتوي الصفحة على مشاهدات أقل من limit؛ اتبع next_cursor حتى تصبح قيمته null.
observations[].periodسلسلة نصيةالشهر أو الربع الرسمي الذي تمثله القراءة.
observations[].first_reported_atطابع زمني وفق RFC 3339لا يظهر إلا مع version=first_reported. يسجل هذا الطابع الزمني بتوقيت UTC متى خزّن Narwhal الفترة لأول مرة (وآخر وقت إذا خُزّنت مقاييسها منفصلة). أما الفترات التي صدرت قبل بدء الالتقاط فتعرض أول التقاط لدى Narwhal.
observations[].valueسلسلة نصية لعدد عشريمستوى المؤشر المعتمد دون تحويل إلى فاصلة عائمة ثنائية.
next_cursorسلسلة نصية أو nullمرّر هذه القيمة دون تغيير في cursor لقراءة الصفحة التالية؛ وتكون null في الصفحة الأخيرة.
المرجع الكامل ←
GETالتضخم/v1/economics/{country}/inflation
استرجع التضخم على أساس سنوي وشهري ومنذ بداية السنة لشهر واحد.
المعلمات
countryمطلوبرمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية.
periodاختياريلا تُرسله للحصول على أحدث إصدار مكتمل مقبول، أو حدّد فترة واحدة بعينها.
version_idاختياريإصدار نشر اختياري غير قابل للتغيير. استخدم resource_version من حدث dataset.published أو dataset.revised، واتركه فارغًا لقراءة المؤشر المعتمد الحالي.
حقول الاستجابة
countryسلسلة نصيةرمز الدولة المطلوب بالأحرف الكبيرة وفق ISO alpha-3.
periodسلسلة نصيةفترة الرصد الرسمية المعادة.
year_over_yearسلسلة نصية لعدد عشريالتغير مقارنة بالشهر نفسه من العام السابق، بالنسبة المئوية.
month_over_monthسلسلة نصية لعدد عشريالتغير مقارنة بالشهر السابق، بالنسبة المئوية.
year_to_dateسلسلة نصية لعدد عشريالتغير مقارنة بشهر ديسمبر السابق، بالنسبة المئوية. يُحذف عندما لا ينشره المصدر.
released_onالتاريختاريخ النشر الرسمي، وليس وقت استرجاع Narwhal.
sourceكائنيظهر الكائن source الاختياري فقط عندما يصل الإحصاء عبر موزّع. ويتضمن publisher (الناشر الأصلي الذي ذكره الموزّع) وdistributor (الجهة الموزِّعة). عند وجود source يكون released_on تاريخ نشر الموزّع لا تاريخ إصدار الناشر الأصلي. السلاسل الواردة مباشرة من الناشر لا تتضمن source.
المرجع الكامل ←
GETسجل التضخم/v1/economics/{country}/inflation/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[].year_over_yearسلسلة نصية لعدد عشريالتغير مقارنة بالشهر نفسه من العام السابق، بالنسبة المئوية.
observations[].month_over_monthسلسلة نصية لعدد عشريالتغير مقارنة بالشهر السابق، بالنسبة المئوية.
observations[].year_to_dateسلسلة نصية لعدد عشريالتغير مقارنة بشهر ديسمبر السابق، بالنسبة المئوية. يُحذف عندما لا ينشره المصدر.
next_cursorسلسلة نصية أو nullمرّر هذه القيمة دون تغيير في cursor لقراءة الصفحة التالية؛ وتكون null في الصفحة الأخيرة.
المرجع الكامل ←
حالات الاستخدام
استخدم حاسبة التضخم لتعديل سعر بحسب التضخم
استخدم مستويات مؤشر CPI لمعرفة قيمة سعر قديم اليوم.
اقرأ الدليل ←CPI على أساس سنوي وشهري
احصل على المعدلات من الواجهة أو احسبها من مستويات المؤشر.
اقرأ الدليل ←اعثر على موعد إصدار CPI القادم
اقرأ الشهر المرجعي والوقت المجدول للإصدار القادم.
اقرأ الدليل ←احسب سعر الفائدة الحقيقي
اطرح التضخم من العائد الاسمي باستخدام معادلة فيشر.
اقرأ الدليل ←احصل على تنبيه قبل الإصدار
اضبط تذكيرًا عبر خلاصة تقويم أو سكربت يومي.
اقرأ الدليل ←التغطية
المؤشرات
الدول
المصادر
- أسترالياالمكتب الأسترالي للإحصاء (ABS)
- النمساإحصاءات النمسا، يوروستات
- بلجيكاStatbel، البنك الوطني البلجيكي، يوروستات
- كنداهيئة الإحصاء الكندية
- سويسراالمكتب الفدرالي السويسري للإحصاء (FSO)، يوروستات
- تشيليالبنك المركزي التشيلي (BCCh)، المعهد الوطني للإحصاء في تشيلي (INE)
- كولومبياالإدارة الوطنية الإدارية للإحصاء (DANE)
- تشيكياالمكتب الإحصائي التشيكي (ČSÚ)
- ألمانياالمكتب الاتحادي للإحصاء في ألمانيا (Destatis)
- الدنماركإحصاءات الدنمارك، يوروستات
- إسبانياالمعهد الوطني للإحصاء في إسبانيا (INE)، وكالة الضرائب الإسبانية (AEAT)
- إستونياإحصاءات إستونيا
عرض كل 36 مصدرًا
- فنلنداإحصاءات فنلندا، الجمارك الفنلندية (Tulli)
- فرنساالمعهد الوطني للإحصاء والدراسات الاقتصادية (INSEE)، الجمارك الفرنسية
- المملكة المتحدةمكتب الإحصاءات الوطنية (ONS)
- كرواتياالمكتب الكرواتي للإحصاء (CBS)
- أيرلندامكتب الإحصاء المركزي (CSO)
- إيطالياالمعهد الوطني الإيطالي للإحصاء (Istat)، يوروستات
- اليابانمكتب الإحصاء الياباني، مكتب مجلس الوزراء الياباني، الجمارك اليابانية
- ليتوانياوكالة بيانات الدولة في ليتوانيا
- لوكسمبورغSTATEC، يوروستات
- لاتفياالمكتب المركزي للإحصاء في لاتفيا (CSB)
- المكسيكالمعهد الوطني للإحصاء والجغرافيا والمعلوماتية (INEGI)
- ماليزيادائرة الإحصاءات الماليزية (DOSM)
- هولنداهيئة الإحصاء الهولندية (CBS)
- النرويجإحصاءات النرويج (SSB)
- الفلبينهيئة الإحصاء الفلبينية (PSA)
- بولنداإحصاءات بولندا، يوروستات
- البرتغالإحصاءات البرتغال (INE)
- قطرNational Planning Council (NPC)، عبر بوابة Qatar Open Data
- المملكة العربية السعوديةالهيئة العامة للإحصاء (GASTAT)
- سنغافورةدائرة الإحصاء السنغافورية (SingStat)، منشورات البيانات الحكومية السنغافورية المفتوحة
- سلوفينياالمكتب الإحصائي لجمهورية سلوفينيا (SURS)
- السويدإحصاءات السويد (SCB)
- الولايات المتحدةمكتب إحصاءات العمل (BLS)، مكتب التحليل الاقتصادي (BEA)، مكتب الإحصاء الأمريكي
- باكستانمكتب الإحصاء الباكستاني (PBS)
واجهات API ذات صلة
واجهة API للبيانات الاقتصادية
مؤشرات رسمية للأسعار والعمل والإنتاج والتجارة والمعدلات.
استكشف API ←واجهة API للتقويم الاقتصادي
جداول الإصدارات وحالتها ونسخ النشر.
استكشف API ←المنهجية
كيفية فحص الإصدارات وتنقيحها.
اقرأ المنهجية ←الأسئلة الشائعة
هل تتوفر مستويات مؤشر أسعار المستهلك ومعدلات التضخم معًا؟
نعم. تشمل التغطية المباشرة مستويات مؤشر أسعار المستهلك ومعدلات التضخم.
هل يمكنني طلب فترة محددة؟
نعم. يمكنك طلب فترة محددة أو جلب سجل تاريخي مؤرخ أو الاستعلام عن أحدث قيمة معتمدة.
من أين تأتي الإحصاءات؟
هي إحصاءات رسمية من جهات النشر الوطنية، منظمة بحسب الدولة.
ابدأ بمفتاح مجاني
رصيد مجاني بقيمة 10 دولارات كل شهر لمدة 12 شهرًا. لا حاجة إلى بطاقة.رصيد مجاني بقيمة 10 دولارات كل شهر. لا حاجة إلى بطاقة.