جميع واجهات API

API بيانات التجارة الدولية

استعلم عن بيانات التجارة الدولية الرسمية للسلع حسب الدولة عبر REST أو MCP. احصل على آخر قيمة معتمدة أو فترة محددة بدقة أو تاريخ مؤرخ كامل للمؤشر.

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

الطلب الأول

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

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

نقاط النهاية

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

استرجع الصادرات والواردات والميزان الدقيق لتجارة السلع لفترة واحدة. تُستبعد الخدمات.

المعلمات

  • countryمطلوب

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

  • periodاختياري

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

  • version_idاختياري

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

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

  • countryسلسلة نصية

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

  • periodسلسلة نصية

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

  • exportsسلسلة نصية لعدد عشري غير سالب

    إجمالي صادرات السلع.

  • importsسلسلة نصية لعدد عشري غير سالب

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

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

    الناتج الدقيق لطرح الواردات من الصادرات؛ وقد يكون سالبًا.

  • currencyسلسلة ISO 4217

    العملة للقيم النقدية الثلاث كلها.

  • released_onالتاريخ

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

  • sourceكائن

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

المرجع الكامل ‏←
GETسجل تجارة السلع/v1/economics/{country}/trade/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

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

  • observationsمصفوفة

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

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

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

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

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

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

    صادرات السلع خلال الفترة. تُحذف عندما لا تتوفر قيمة للفترة.

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

    واردات السلع خلال الفترة. تُحذف عندما لا تتوفر قيمة للفترة.

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

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

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

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

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

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

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

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

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

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

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

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

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

التغطية

المؤشرات

الدول

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

المصادر

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

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

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

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

استكشف API ‏←

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

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

استكشف API ‏←

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

ما نوع التجارة التي تغطيها؟

يغطي هذا النوع إحصاءات تجارة السلع الرسمية من جهات النشر الوطنية.

هل يمكنني طلب بيانات التجارة لفترة محددة بدقة؟

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

هل يمكنني الوصول إلى بيانات التجارة عبر MCP؟

نعم. بيانات التجارة متاحة عبر MCP وREST بمفتاح API نفسه.