حمّل بيانات الشركات لسنوات
تصفح سجلًا تاريخيًا طويلًا واستأنف إذا توقفت المهمة.
اقرأ الدليل ←جميع واجهات API
ESEF API للإفصاحات السنوية للشركات
احصل على القوائم المالية السنوية لنحو 3,200 شركة.
الطلب الأول
احصل على البيانات المالية السنوية
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies/nld:724500Y6DUVHQD6OXN27/financials?period=annual&fields=revenue,net_income,total_assets" \
--header "Authorization: Bearer $NARWHAL_API_KEY"استجابة نموذجية
{
"id": "nld:724500Y6DUVHQD6OXN27",
"currency": "EUR",
"annual": [
{
"fy": 2025,
"end": "2025-12-31",
"derived": [],
"revenue": "32667300000",
"net_income": "10213000000",
"total_assets": "55576800000"
}
],
"as_of": "2026-02-25"
}نقاط النهاية
GETسرد الشركات/v1/companies
ابحث عن الشركات بالاسم واحصل على معرّفاتها. استخدم المعرّف في كل الطلبات الأخرى.
المعلمات
qاختيارينص البحث، مثل اسم شركة.
المرجع الكامل ←
GETاعرض إفصاحات الشركة/v1/companies/{company_id}/filings
إفصاحات الشركة، الأحدث أولًا، مع رابط لكل نسخة رسمية.
المعلمات
company_idمطلوبمعرّف شركة مثل usa:0000789019، أو اسم مستعار للرمز مثل usa:MSFT.
typeاختياريفئة الإفصاح، مثل annual.
المرجع الكامل ←
GETاحصل على القوائم المالية الموحدة للشركات/v1/companies/{company_id}/financials
قوائم مالية موحدة للشركة، صف لكل فترة، بالعملة التي تقدم بها الشركة إفصاحاتها.
المعلمات
company_idمطلوبمعرّف شركة مثل usa:0000789019، أو اسم مستعار للرمز مثل usa:MSFT.
periodاختياريannual أو semiannual بحسب السجل.
statementاختياريincome أو balance أو cash_flow أو per_share.
fieldsاختياريأسماء عناصر مفصولة بفواصل، مثل revenue,net_income.
المرجع الكامل ←
حالات الاستخدام
التحديث وفق جدول زمني
اجلب الإفصاحات والأرقام الجديدة كل يوم بسكربت صغير.
اقرأ الدليل ←ابقَ ضمن حدودك
خزّن الردود مؤقتًا وتعامل مع أخطاء 429 دون فقدان أي طلب.
اقرأ الدليل ←اسأل وكيلًا ذكيًا عن شركة
امنح وكيل LLM صلاحية قراءة الإفصاحات والبيانات المالية عبر MCP.
اقرأ الدليل ←التغطية
- الاتحاد الأوروبي والمنطقة الاقتصادية الأوروبيةنحو 3,200 شركة في 26 دولة، سنوي فقط.
المصادر
- الاتحاد الأوروبي والمنطقة الاقتصادية الأوروبيةالتقارير السنوية بصيغة ESEF
واجهات API ذات صلة
تقارير الشركات المدرجة في بريطانيا عبر API التقارير المالية للشركات البريطانية
التقارير السنوية للمصدرين في الأسواق المنظمة بالمملكة المتحدة
استكشف API ←MOPS API لإفصاحات تايوان وقوائمها
البيانات المالية للشركات التايوانية من TWSE OpenAPI وبيانات TPEx المفتوحة على data.gov.tw
استكشف API ←SEC EDGAR API عبر Narwhal
إفصاحات الولايات المتحدة المباشرة والبيانات المالية XBRL الموحدة من SEC EDGAR
استكشف API ←API إفصاحات الشركات للقوائم والسجلات
قوائم الإفصاحات والسجلات الفردية وأحدث الإفصاحات عبر الشركات
استكشف API ←الأسئلة الشائعة
كيف تعمل معرّفات شركات ESEF؟
تجمع معرّفات الشركات بين رمز الدولة ورمز LEI الخاص بالشركة، مثل nld:<LEI>. وقد تظهر الشركة المدرجة في دولتين تحت كل دولة.
هل تشمل البيانات القوائم ربع السنوية أو نصف السنوية؟
لا. التغطية للتقارير السنوية فقط، دون قوائم ربع سنوية أو نصف سنوية.
هل تشمل البيانات حاملي 5% أو أكثر؟
لا. حاملو 5% أو أكثر غير مشمولين لهذه الشركات.
اختر حقول القائمة
اختر بنود القائمة باستخدام fields=revenue,net_income,total_assets.
التقارير السنوية فقط
استخدم period=annual لطلب القوائم السنوية.
العملات كما وردت في الإفصاح
تبقى المبالغ بالعملة التي تُبلّغ بها كل شركة، كما وردت في الإفصاح.
ابدأ بمفتاح مجاني
رصيد مجاني بقيمة 10 دولارات كل شهر لمدة 12 شهرًا. لا حاجة إلى بطاقة.رصيد مجاني بقيمة 10 دولارات كل شهر. لا حاجة إلى بطاقة.