جميع واجهات 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",
  "base_period": "1982-84",
  "base_value": "100",
  "released_on": "2026-08-12"
}

نقاط النهاية

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

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

country: رمز دولة واحد مدعوم بأحرف كبيرة: AUS وCAN وDEU وFRA وGBR وJPN وMYS وNLD وSGP وUSA.
period: اتركه لأحدث إصدار مكتمل مقبول، أو مرر فترة واحدة دقيقة.

MCP · economics_get_cpi

مرجع API →السجل →

GETالتضخم/v1/economics/{country}/inflation

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

country: رمز دولة واحد مدعوم بأحرف كبيرة: AUS وCAN وDEU وFRA وGBR وJPN وMYS وNLD وSGP وUSA.
period: اتركه لأحدث إصدار مكتمل مقبول، أو مرر فترة واحدة دقيقة.

MCP · economics_get_inflation

مرجع API →السجل →

GETالبطالة/v1/economics/{country}/unemployment

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

country: رمز دولة واحد مدعوم بأحرف كبيرة: AUS وCAN وDEU وFRA وGBR وJPN وMYS وNLD وSGP وUSA.
period: اتركه لأحدث إصدار مكتمل مقبول، أو مرر فترة واحدة دقيقة.

MCP · economics_get_unemployment

مرجع API →السجل →

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

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

country: رمز دولة واحد مدعوم بأحرف كبيرة: AUS وCAN وDEU وFRA وGBR وJPN وMYS وNLD وSGP وUSA.
period: اتركه لأحدث إصدار مكتمل مقبول، أو مرر فترة واحدة دقيقة.

MCP · economics_get_labour_force_participation

مرجع API →السجل →

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

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

country: رمز دولة واحد مدعوم بأحرف كبيرة: AUS وCAN وDEU وFRA وGBR وJPN وMYS وNLD وSGP وUSA.
period: اتركه لأحدث إصدار مكتمل مقبول، أو مرر فترة واحدة دقيقة.

MCP · economics_get_gdp

مرجع API →السجل →

GETنمو GDP/v1/economics/{country}/gdp-growth

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

country: رمز دولة واحد مدعوم بأحرف كبيرة: AUS وCAN وDEU وFRA وGBR وJPN وMYS وNLD وSGP وUSA.
period: اتركه لأحدث إصدار مكتمل مقبول، أو مرر فترة واحدة دقيقة.

MCP · economics_get_gdp_growth

مرجع API →السجل →

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

استرجع الصادرات والواردات والرصيد الدقيق لتجارة البضائع لفترة واحدة.

country: رمز دولة واحد مدعوم بأحرف كبيرة: AUS وCAN وDEU وFRA وGBR وJPN وMYS وNLD وSGP وUSA.
period: اتركه لأحدث إصدار مكتمل مقبول، أو مرر فترة واحدة دقيقة.

MCP · economics_get_trade

مرجع API →السجل →

GETصادرات السلع/v1/economics/{country}/trade/exports

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

country: رمز دولة واحد مدعوم بأحرف كبيرة: AUS وCAN وDEU وFRA وGBR وJPN وMYS وNLD وSGP وUSA.
period: اتركه لأحدث إصدار مكتمل مقبول، أو مرر فترة واحدة دقيقة.
partner: مقبول بموجب العقد، لكن إجماليات الشريك المصفاة غير منشورة في الإصدار التجريبي الحالي.
product: رمز منتج HS. أرسله مع التصنيف.
classification: إصدار النظام المنسق. زوّده مع product.

MCP · economics_get_trade_exports

مرجع API →السجل →

GETواردات السلع/v1/economics/{country}/trade/imports

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

country: رمز دولة واحد مدعوم بأحرف كبيرة: AUS وCAN وDEU وFRA وGBR وJPN وMYS وNLD وSGP وUSA.
period: اتركه لأحدث إصدار مكتمل مقبول، أو مرر فترة واحدة دقيقة.
partner: مقبول بموجب العقد، لكن إجماليات الشريك المصفاة غير منشورة في الإصدار التجريبي الحالي.
product: رمز منتج HS. أرسله مع التصنيف.
classification: إصدار النظام المنسق. زوّده مع product.

MCP · economics_get_trade_imports

مرجع API →السجل →