جميع واجهات API

واجهة API لواردات السلع

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

الطلب الأول

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

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

{
  "country": "USA",
  "period": "2026-06",
  "flow": "import",
  "value": "275000000000",
  "currency": "USD",
  "coverage": "merchandise",
  "partner": null,
  "product": null,
  "released_on": "2026-08-04"
}

نقاط النهاية

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 →

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

country: رمز دولة واحد مدعوم بأحرف كبيرة: AUS وCAN وDEU وFRA وGBR وJPN وMYS وNLD وSGP وUSA.
start: فترة الملاحظة الأولى الشاملة.
end: فترة الملاحظة الأخيرة الشاملة.
limit: الحد الأقصى للملاحظات المعادة. الافتراضي 100.
cursor: قيمة next_cursor من الصفحة السابقة.

MCP · economics_get_trade_imports_history

مرجع API →

السجل

cURL

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

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

{
  "observations": [
    {
      "country": "USA",
      "measure": "trade_imports",
      "value": "275000000000",
      "unit": "USD",
      "transformation": "",
      "period": "2026-06"
    }
  ],
  "next_cursor": null,
  "as_of": "2026-08-29T16:00:00Z"
}

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

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

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

اقرأ المنهجية →

فترات صريحة

اتركه لأحدث إصدار مكتمل مقبول، أو مرر فترة واحدة دقيقة.

REST وMCP

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

التغطية

عرض التغطية →

AUS CAN DEU FRA GBR JPN MYS NLD SGP USA

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

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

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

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

YYYY أو YYYY-MM

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

إجماليات واردات السلع الوطنية غير المصفاة متاحة للعامة للدول AUS وCAN وDEU وFRA وGBR وJPN وMYS وNLD وSGP وUSA. يقبل العقد مرشحات الشريك والمنتج، لكنها تعيد 404 حتى تُنشر الإجماليات المصفاة.

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

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