メインコンテンツへスキップ
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
    }
  ]
}

承認

​
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) لآخر تحديث للسجلات. سيؤدي هذا إلى فرض ترتيب فرز بشرط أن يكون أكبر من أو يساوي الطابع الزمني المُشار إليه

レスポンス

نجاح

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

​
earnings
object[]