جميع واجهات 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}/cpi/observations

country: رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية.
start: أول فترة رصد، وهي مشمولة. في خطتَي Free وBasic، تُنقل البداية التي تسبق نافذة خطتك إلى أول فترة داخلها. وتتضمن الاستجابة عندئذٍ start.
end: آخر فترة رصد، وهي مشمولة في النتائج.
limit: الحد الأقصى لعدد الفترات المُعادة. القيمة الافتراضية 100. قد تحتوي الصفحة على فترات أقل؛ اتبع next_cursor.
cursor: قيمة next_cursor من الصفحة السابقة.

MCP · economics_get_cpi_history

مرجع API ‏←

السجل

cURL

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/cpi/observations?start=2026-07&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

استجابة نموذجية استجابة توضيحية · ليست طلبًا مباشرًا

{
  "country": "USA",
  "index_base": "1982-84=100",
  "as_of": "2026-08-12T00:00:00Z",
  "observations": [
    {
      "period": "2026-07",
      "value": "333.918"
    }
  ],
  "next_cursor": null
}

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

المصادر الأولية

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

اقرأ المنهجية ‏←

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

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

REST وMCP

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

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

مرجع API

المعلمات وحقول الاستجابة.

اقرأ التوثيق ‏←

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

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

استكشف API ‏←

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

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

استكشف API ‏←

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

هل مؤشر أسعار المستهلك هو نفسه التضخم؟

مؤشر أسعار المستهلك هو قيمة مؤشر، بينما يقيس التضخم نسبة تغير الأسعار؛ استخدم واجهة API للتضخم عندما تحتاج إلى معدل التضخم.

هل يمكنني مقارنة قيم مؤشر أسعار المستهلك بين الدول؟

تحقق من index_base قبل مقارنة مستويات المؤشر، فقد تستخدم البلدان أسس مرجعية مختلفة.

كيف أطلب أحدث مؤشر لأسعار المستهلك؟

لا تُرسل period للحصول على أحدث إصدار مكتمل مقبول، أو حدّد شهرًا بصيغة YYYY-MM.

هل تغطي API لمؤشر أسعار المستهلك دولًا حول العالم؟

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

هل يمكنني استخدام API لمؤشر أسعار المستهلك مجانًا؟

نعم، يتوفر مؤشر أسعار المستهلك في جميع الخطط، بما فيها Free، ولا تحتاج خطة Free إلى بطاقة. تتضمن Free عدد 5,000 طلب ناجح شهريًا والبيانات التاريخية لآخر 12 شهرًا؛ وتتضمن Basic البيانات التاريخية لآخر 5 سنوات، بينما تتضمن Pro كامل البيانات التاريخية.

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

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