جميع واجهات API

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

معدلات النمو الفصلية الرسمية للناتج المحلي الإجمالي الحقيقي.

الطلب الأول

دليل البدء السريع ‏←
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/gdp-growth?period=2026-Q2" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
استجابة نموذجية استجابة توضيحية · ليست طلبًا مباشرًا
{
  "country": "USA",
  "period": "2026-Q2",
  "year_over_year": "2.4",
  "quarter_over_quarter": "0.503",
  "released_on": "2026-07-30"
}

نقاط النهاية

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

MCP · economics_get_gdp_growth

مرجع API ‏←
GETسجل نمو الناتج المحلي الإجمالي/v1/economics/{country}/gdp-growth/observations
country
رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية.
start
أول فترة رصد، وهي مشمولة. في خطتَي Free وBasic، تُنقل البداية التي تسبق نافذة خطتك إلى أول فترة داخلها. وتتضمن الاستجابة عندئذٍ start.
end
آخر فترة رصد، وهي مشمولة في النتائج.
limit
الحد الأقصى لعدد الفترات المُعادة. القيمة الافتراضية 100. قد تحتوي الصفحة على فترات أقل؛ اتبع next_cursor.
cursor
قيمة next_cursor من الصفحة السابقة.

MCP · economics_get_gdp_growth_history

مرجع API ‏←

السجل

cURL
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/gdp-growth/observations?start=2026-Q2&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
استجابة نموذجية استجابة توضيحية · ليست طلبًا مباشرًا
{
  "country": "USA",
  "as_of": "2026-08-12T00:00:00Z",
  "observations": [
    {
      "period": "2026-Q2",
      "year_over_year": "2.4",
      "quarter_over_quarter": "0.503"
    }
  ],
  "next_cursor": null
}

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

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

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

REST وMCP

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

التغطية

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

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

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

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

استكشف API ‏←

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

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

استكشف API ‏←

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

ما الذي تتضمنه الاستجابة؟

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

ما الفترات التي يمكنني طلبها؟

YYYY-QN

ما نطاق التغطية المتاح؟

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

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

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