메인 콘텐츠로 건너뛰기
GET
/
api
/
v2.1
/
calendar
/
earnings
يُرجِع بيانات الأرباح
curl --request GET \
  --url 'https://api.benzinga.com/api/v2.1/calendar/earnings?token=' \
  --header 'accept: <accept>'
import requests

url = "https://api.benzinga.com/api/v2.1/calendar/earnings?token="

headers = {"accept": "<accept>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {accept: '<accept>'}};

fetch('https://api.benzinga.com/api/v2.1/calendar/earnings?token=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.benzinga.com/api/v2.1/calendar/earnings?token=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"accept: <accept>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://api.benzinga.com/api/v2.1/calendar/earnings?token="

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("accept", "<accept>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.benzinga.com/api/v2.1/calendar/earnings?token=")
.header("accept", "<accept>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.benzinga.com/api/v2.1/calendar/earnings?token=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accept"] = '<accept>'

response = http.request(request)
puts response.read_body
{
  "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
    }
  ]
}
{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "인증 토큰이 없거나 유효하지 않습니다"
    }
  ]
}
{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "지정된 매개변수에 해당하는 데이터를 찾을 수 없습니다"
    }
  ]
}
{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "요청을 처리하는 동안 예기치 않은 오류가 발생했습니다"
    }
  ]
}
{
  "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
    }
  ]
}
{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "인증 토큰이 없거나 유효하지 않습니다"
    }
  ]
}
{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "지정된 매개변수에 해당하는 데이터를 찾을 수 없습니다"
    }
  ]
}
{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "요청을 처리하는 동안 예기치 않은 오류가 발생했습니다"
    }
  ]
}

인증

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[]