نظرة سريعة
إحصاءات الطاقة من EIA والبيانات الاقتصادية للدول من Narwhal تخدمان مهمتين مختلفتين.
| المتطلب | واجهة Narwhal API | EIA API |
|---|---|---|
| الباقة المجانية | ✓ رصيد مجاني بقيمة $10 شهريًا لمدة 12 شهرًا، دون بطاقة | ✓ مفتاح API مجاني بعد التسجيل |
| أرخص باقة مدفوعة | شحن يبدأ من $20؛ من $2 إلى $10 لكل 1,000 استدعاء | لا توجد خطة مدفوعة منشورة |
| سرعة التحديث | وفق جدول كل مجموعة بيانات؛ تُحفظ الطوابع الزمنية | وفق جدول كل مجموعة بيانات؛ المجمّعة مرتين يوميًا |
| السجل | السجل الكامل لكل حساب؛ السجلات المتاحة فقط | يعتمد على مجموعة البيانات |
| التغطية | البيانات الاقتصادية والعملات والعطلات والسلع المنشورة | إحصاءات الطاقة والتوقعات |
| الواجهات | REST وMCP؛ WebSocket غير منشور | REST وتنزيلات مجمّعة وExcel وأدوات مضمّنة |
| حزم SDK | ✓ حزم SDK رسمية لـ Python وTypeScript | غير منشورة |
| الاستخدام التجاري في الباقة المجانية | ✓ التطبيقات التجارية مسموحة؛ وإعادة البيع تتطلب اتفاقًا مخصصًا | تسري سياسة إعادة الاستخدام |
السعر بحسب استخدامك
بيانات الطاقة من EIA مجانية مع تقييد معدل الطلبات؛ أما أسعار Narwhal فتخص كتالوجها الاقتصادي المنفصل.
| عدد الطلبات شهرياً | واجهة Narwhal API | EIA API |
|---|---|---|
| 1,000 | $2.00 بسعر $2 لكل 1,000 استدعاء | بيانات مفتوحة: $0؛ مع تقييد معدل الطلبات |
| 10,000 | $20.00 بسعر $2 لكل 1,000 استدعاء | بيانات مفتوحة: $0؛ مع تقييد معدل الطلبات |
| 100,000 | $200.00 بسعر $2 لكل 1,000 استدعاء | بيانات مفتوحة: $0؛ مع تقييد معدل الطلبات |
انتقل في بضع دقائق
قراءة أسعار المستهلك في الولايات المتحدة
EIA API
تقدّم EIA API إحصاءات الطاقة الأمريكية وتوقعاتها، دون بيانات مؤشر أسعار المستهلك.
واجهة Narwhal API
# Change: URL and key
curl \
"https://api.narwhalapi.com/v1/economics/USA/cpi" \
-H "Authorization: Bearer YOUR_API_KEY"لماذا ينتقل الفرق
ابدأ البناء مجانًا
يحصل كل حساب في Narwhal على رصيد مجاني بقيمة $10 شهريًا لمدة 12 شهرًا، مع السماح بالتطبيقات التجارية. استخدم هذا الرصيد للوحة معلومات أو لجلب بيانات مجدول أو لتكامل مع وكيل. ومع نمو الاستخدام أضف شحنًا يبدأ من $20، بالحساب والمصادقة نفسيهما.
اربط تطبيقك ووكيلك
يصل REST وMCP المستضاف إلى البيانات نفسها عبر حساب واحد. يستطيع تطبيقك جلب JSON بينما يستخدم الوكيل الأدوات المستضافة، ويُحاسَب كل استدعاء مرة واحدة من الرصيد المشترك. ومع رصيد واحد يسهل تقدير ميزانية الحمل المجمّع.
اربط بيانات الدول
يغطي كتالوج Narwhal الاقتصادي 37 دولة، مع جدول تغطية لكل مؤشر. تنظّم مساراتُ الدولة والمؤشر طلباتك حول البيانات التي يستخدمها تطبيقك. اجمع الملاحظات مع العملات والعطلات الرسمية وتواريخ الإصدار لبناء لوحات معلومات للدول عبر الحساب نفسه.
متى يكون الخيار الآخر أفضل
تُعدّ EIA الخيار الأفضل لإحصاءات الطاقة التفصيلية والتوقعات وملفات الطاقة المجمّعة. واجهتها مجانية بمفتاح مسجّل، وهي الطريق المباشر إلى مجموعات بيانات الطاقة هذه. ولا تملك Narwhal نقطة نهاية مكافئة لإحصاءات الطاقة الحية: فمثال CPI يدعم سير عمل اقتصاديًا مختلفًا ولا يحلّ محل سلاسل EIA. ويمكن للتطبيق الذي يبحث في الطاقة والاقتصاد الأوسع أن يستخدم المصدرين، كلٌّ لمهمته.
أسئلة شائعة
هل يوجد بديل مجاني لـ EIA API؟
نعم. تمنح Narwhal كل حساب رصيدًا مجانيًا بقيمة $10 شهريًا لمدة 12 شهرًا، مع السماح باستخدام التطبيقات التجارية والوصول عبر REST وMCP المستضاف. يغطي ذلك مؤشرات الدول والعملات والتقاويم، بينما تبقى مجموعات بيانات الطاقة من EIA مصدرًا منفصلًا.
كم يمكن أن يعيد طلب EIA واحد؟
تسمح API v2 بما يصل إلى 5,000 صف JSON في كل استجابة، مع حد أصغر لـ XML. استخدم الترقيم للنتائج الأكبر أو التنزيلات المجمّعة. تطبّق EIA تقييدًا لمعدل الطلبات، وقد توقف المفتاح مؤقتًا عند الاستخدام المفرط.
ما الذي يتغيّر في تطبيقي؟
استبدل عنوان الطلب والمصادقة، ثم اربط استجابة JSON بحقول تطبيقك. تستخدم الأمثلة fetch القياسي في JavaScript وrequests في Python، فيناسب التكامل أي عميل HTTP عادي. احتفظ بمفتاحك على الخادم، وانقل وحدات الاستجابة وتواريخها وقيمها المفقودة إلى العرض أو الحسابات.
ماذا يحدث عند نفاد رصيد Narwhal؟
يُشارَك رصيد بين استدعاءات REST وMCP. عندما يصل إلى الصفر تُرجع الواجهة HTTP 402 `insufficient_credits`، ولا يمكن أن تُحاسَب بأكثر من رصيدك. لا يُرحَّل الرصيد المجاني، وينتهي الرصيد المدفوع بعد 12 شهرًا من آخر شحن.
تمت المراجعة: