Saltar al contenido principal
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
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.benzinga.com/llms.txt

Use this file to discover all available pages before exploring further.

{
  "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
    }
  ]
}

Autorizaciones

​
token
string
query
requerido

Encabezados

​
accept
enum<string>
predeterminado:application/json
requerido

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

Opciones disponibles:
application/json

Parámetros de consulta

​
page
integer
predeterminado: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 لترتيب النتائج

Opciones disponibles:
date
​
parameters[importance]
enum<integer>

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

Opciones disponibles:
0,
1,
2,
3,
4,
5
​
parameters[tickers]
string<csv>

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

​
parameters[updated]
integer

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

Respuesta

نجاح

استجابة واجهة برمجة التطبيقات API التي تتضمن مصفوفة سجلات للأرباح

​
earnings
object[]