جميع واجهات API

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

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

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

الطلب الأول

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

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

نقاط النهاية

GETالناتج المحلي الإجمالي/v1/economics/{country}/gdp

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

المعلمات

  • countryمطلوب

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

  • periodاختياري

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

  • version_idاختياري

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

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

  • countryسلسلة نصية

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

  • periodسلسلة نصية

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

  • valueسلسلة نصية لعدد عشري موجب

    قيمة الناتج المحلي الإجمالي بالأسعار الجارية.

  • currencyسلسلة ISO 4217

    العملة الوطنية لقيمة الناتج المحلي الإجمالي.

  • not_seasonally_adjustedصحيح

    يظهر بالقيمة true فقط عندما تكون السلسلة الرسمية غير معدّلة موسميًا.

  • annualizedصحيح

    يظهر بالقيمة true فقط عندما يكون المستوى الرسمي محوّلًا إلى أساس سنوي.

  • released_onالتاريخ

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

  • sourceكائن

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

المرجع الكامل ‏←
GETسجل الناتج المحلي الإجمالي/v1/economics/{country}/gdp/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كائن

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

  • currencyسلسلة ISO 4217

    العملة الوطنية لجميع القيم في الصفحة.

  • not_seasonally_adjustedصحيح

    يظهر بالقيمة true فقط عندما تكون الأرقام غير معدّلة موسميًا.

  • annualizedصحيح

    يظهر بالقيمة true فقط عندما تكون الأرقام محوّلة إلى أساس سنوي.

  • 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}/gdp-growth

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

المعلمات

  • countryمطلوب

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

  • periodاختياري

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

  • version_idاختياري

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

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

  • countryسلسلة نصية

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

  • periodسلسلة نصية

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

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

    التغير الحقيقي في GDP مقارنة بالفصل نفسه من العام السابق، بالنسبة المئوية.

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

    التغير الحقيقي في GDP مقارنة بالفصل السابق، بالنسبة المئوية، دون تحويله إلى أساس سنوي.

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

    النمو الرسمي منذ بداية العام، بالنسبة المئوية، عندما ينشره المصدر؛ ويُحذف خلاف ذلك.

  • not_seasonally_adjustedصحيح

    يظهر بالقيمة true فقط عندما تكون معدلات النمو غير معدّلة موسميًا.

  • annualizedصحيح

    يظهر بالقيمة true فقط عندما يكون معدل النمو المنشور محوّلًا إلى أساس سنوي.

  • year_over_year_not_seasonally_adjustedصحيح

    يظهر بالقيمة true فقط لبلد يجمع بين أسس مختلفة، ويكون رقم التغير مقارنة بالعام السابق غير معدّل موسميًا. عندئذ تغيب العلامة على المستوى الأعلى.

  • quarter_over_quarter_not_seasonally_adjustedصحيح

    يظهر بالقيمة true فقط لبلد يجمع بين أسس مختلفة، ويكون رقم التغير مقارنة بالفصل السابق غير معدّل موسميًا. عندئذ تغيب العلامة على المستوى الأعلى.

  • released_onالتاريخ

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

  • sourceكائن

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

المرجع الكامل ‏←
GETسجل نمو الناتج المحلي الإجمالي/v1/economics/{country}/gdp-growth/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كائن

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

  • not_seasonally_adjustedصحيح

    يظهر بالقيمة true فقط عندما تكون الأرقام غير معدّلة موسميًا.

  • annualizedصحيح

    يظهر بالقيمة true فقط عندما تكون الأرقام محوّلة إلى أساس سنوي.

  • year_over_year_not_seasonally_adjustedصحيح

    يظهر بالقيمة true فقط لبلد يجمع بين أسس مختلفة ويكون رقم التغير مقارنة بالعام السابق غير معدّل موسميًا.

  • quarter_over_quarter_not_seasonally_adjustedصحيح

    يظهر بالقيمة true فقط لبلد يجمع بين أسس مختلفة ويكون رقم التغير مقارنة بالفصل السابق غير معدّل موسميًا.

  • observationsمصفوفة

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

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

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

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

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

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

    التغير الحقيقي مقارنة بالفصل نفسه من العام السابق، بالنسبة المئوية.

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

    التغير الحقيقي مقارنة بالفصل السابق، بالنسبة المئوية، دون تحويله إلى أساس سنوي.

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

    التغير الحقيقي منذ بداية العام، بالنسبة المئوية. يُحذف عندما لا ينشره المصدر.

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

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

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

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

النمو من مستويات الناتج المحلي

احسب النمو الفصلي واعرضه كمعدل سنوي.

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

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

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

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

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

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

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

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

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

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

التغطية

المؤشرات

الدول

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

المصادر

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

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

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

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

استكشف API ‏←

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

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

استكشف API ‏←

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

هل تشمل التغطية المباشرة نمو الناتج المحلي الإجمالي؟

نعم. مستويات الناتج المحلي الإجمالي ونموه متاحان مباشرة اليوم.

هل يمكنني الاستعلام عن فترة إبلاغ محددة؟

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

من أين تأتي بيانات الناتج؟

ينشر الـ API إحصاءات رسمية من جهات النشر الوطنية، منظمة بحسب الدولة.