الانتقال إلى المحتوى الرئيسي
GET
/
api
/
v2.1
/
calendar
/
earnings
يُرجِع بيانات الأرباح
curl --request GET \
  --url 'https://api.benzinga.com/api/v2.1/calendar/earnings?token=' \
  --header 'accept: <accept>'
{
  "earnings": [
    {
      "currency": "USD",
      "cusip": "037833100",
      "date": "2026-10-29",
      "date_confirmed": 0,
      "eps": "",
      "eps_est": "1.990",
      "eps_prior": "1.850",
      "eps_surprise": "",
      "eps_surprise_percent": "",
      "eps_type": "",
      "exchange": "NASDAQ",
      "id": "69030cfb619d3a00015b72a3",
      "importance": 5,
      "isin": "US0378331005",
      "name": "Apple",
      "notes": "",
      "period": "Q4",
      "period_year": 2026,
      "revenue": "",
      "revenue_est": "",
      "revenue_prior": "102466000000.000",
      "revenue_surprise": "",
      "revenue_surprise_percent": "",
      "revenue_type": "",
      "ticker": "AAPL",
      "time": "16:00:00",
      "updated": 1766187011
    }
  ]
}

{
  "earnings": [
    {
      "currency": "USD",
      "cusip": "037833100",
      "date": "2026-10-29",
      "date_confirmed": 0,
      "eps": "",
      "eps_est": "1.990",
      "eps_prior": "1.850",
      "eps_surprise": "",
      "eps_surprise_percent": "",
      "eps_type": "",
      "exchange": "NASDAQ",
      "id": "69030cfb619d3a00015b72a3",
      "importance": 5,
      "isin": "US0378331005",
      "name": "Apple",
      "notes": "",
      "period": "Q4",
      "period_year": 2026,
      "revenue": "",
      "revenue_est": "",
      "revenue_prior": "102466000000.000",
      "revenue_surprise": "",
      "revenue_surprise_percent": "",
      "revenue_type": "",
      "ticker": "AAPL",
      "time": "16:00:00",
      "updated": 1766187011
    }
  ]
}

التفويضات

​
token
string
query
مطلوب

الترويسات

​
accept
enum<string>
افتراضي:application/json
مطلوب

يحدِّد تنسيق الاستجابة. تعمل معلمات الاستعلام بالطريقة نفسها في كلا التنسيقين

الخيارات المتاحة:
application/json

معلمات الاستعلام

​
page
integer
افتراضي:0

إزاحة الصفحة. لأسباب تتعلق بالتحسين والأداء والاعتبارات التقنية، تُقيَّد قيم إزاحة الصفحة بين 0 و100000. احصر نتائج الاستعلام باستخدام معاملات أخرى مثل التاريخ.

​
pagesize
integer

عدد النتائج المُرجَعة. الحد الأقصى 1000

​
parameters[date]
string<YYYY-MM-DD>

التاريخ المستخدم للاستعلام عن بيانات calendar. اختصار لـ date_from و date_to إذا كانتا متطابقتين. وفي حال عدم التحديد، تكون القيمة الافتراضية هي الأحدث

​
parameters[date_from]
string<YYYY-MM-DD>

تاريخ بدء الاستعلام كنقطة زمنية محددة

​
parameters[date_to]
string<YYYY-MM-DD>

تاريخ الاستعلام حتى هذه النقطة الزمنية

​
parameters[date_sort]
enum<string>

خيار حقل الفرز لتقويم الأرباح. استخدم :desc أو :asc لترتيب النتائج

الخيارات المتاحة:
date
​
parameters[importance]
enum<integer>

مستوى الأهمية للتصفية حسبه. يستخدم مقارنة «أكبر من أو يساوي» مع مستوى الأهمية المحدد

الخيارات المتاحة:
0,
1,
2,
3,
4,
5
​
parameters[tickers]
string<csv>

رمز تداول واحد أو أكثر مفصولة بفواصل. الحد الأقصى 50 رمز تداول

​
parameters[updated]
integer

الطابع الزمني بنظام Unix (بتوقيت UTC) لآخر تحديث للسجلات. سيؤدي هذا إلى فرض ترتيب فرز بشرط أن يكون أكبر من أو يساوي الطابع الزمني المُشار إليه

الاستجابة

نجاح

​
earnings
object[]