الانتقال إلى المحتوى الرئيسي
GET
/
api
/
v2.1
/
calendar
/
ratings
يُرجِع بيانات توصيات المحللين
curl --request GET \
  --url 'https://api.benzinga.com/api/v2.1/calendar/ratings?token=' \
  --header 'accept: <accept>'
import requests

url = "https://api.benzinga.com/api/v2.1/calendar/ratings?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/ratings?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/ratings?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/ratings?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/ratings?token=")
  .header("accept", "<accept>")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.benzinga.com/api/v2.1/calendar/ratings?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
{
  "ratings": [
    {
      "action_company": "Maintains",
      "action_pt": "Lowers",
      "adjusted_pt_current": "260.00",
      "adjusted_pt_prior": "300.00",
      "analyst": "Jefferies",
      "analyst_id": "57fe0358ac6af40001334e62",
      "analyst_name": "Brent Thill",
      "currency": "USD",
      "cusip": "001176213",
      "date": "2026-01-05",
      "exchange": "NASDAQ",
      "id": "695c16678f047b0001fee512",
      "importance": 3,
      "isin": "IL0011762130",
      "name": "Monday.Com",
      "notes": "",
      "pt_current": "260.0000",
      "pt_pct_change": "-13.33",
      "pt_prior": "300.00",
      "rating_current": "Buy",
      "rating_prior": "Buy",
      "ticker": "MNDY",
      "time": "14:52:07",
      "updated": 1767642765,
      "url": "https://www.benzinga.com/quote/MNDY/analyst-ratings",
      "url_calendar": "https://www.benzinga.com/quote/MNDY/analyst-ratings",
      "url_news": "https://www.benzinga.com/stock-articles/MNDY/analyst-ratings"
    }
  ]
}
{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "Invalid or missing authentication token"
    }
  ]
}
{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "No data found for the specified parameters"
    }
  ]
}
{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "An unexpected error occurred while processing your request"
    }
  ]
}
{
  "ratings": [
    {
      "action_company": "Maintains",
      "action_pt": "Lowers",
      "adjusted_pt_current": "260.00",
      "adjusted_pt_prior": "300.00",
      "analyst": "Jefferies",
      "analyst_id": "57fe0358ac6af40001334e62",
      "analyst_name": "Brent Thill",
      "currency": "USD",
      "cusip": "001176213",
      "date": "2026-01-05",
      "exchange": "NASDAQ",
      "id": "695c16678f047b0001fee512",
      "importance": 3,
      "isin": "IL0011762130",
      "name": "Monday.Com",
      "notes": "",
      "pt_current": "260.0000",
      "pt_pct_change": "-13.33",
      "pt_prior": "300.00",
      "rating_current": "Buy",
      "rating_prior": "Buy",
      "ticker": "MNDY",
      "time": "14:52:07",
      "updated": 1767642765,
      "url": "https://www.benzinga.com/quote/MNDY/analyst-ratings",
      "url_calendar": "https://www.benzinga.com/quote/MNDY/analyst-ratings",
      "url_news": "https://www.benzinga.com/stock-articles/MNDY/analyst-ratings"
    }
  ]
}
{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "Invalid or missing authentication token"
    }
  ]
}
{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "No data found for the specified parameters"
    }
  ]
}
{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "An unexpected error occurred while processing your request"
    }
  ]
}

التفويضات

token
string
query
مطلوب

الترويسات

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

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

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

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

fields
string<csv>

قائمة بالحقول المطلوب إرجاعها مفصولة بفواصل. الحقول المتاحة: id، date، time، ticker، exchange، name، currency، action_pt، action_company، rating_current، pt_current، rating_prior، pt_prior، pt_pct_change، url، url_calendar، url_news، analyst، analyst_id، analyst_name، ratings_accuracy، importance، notes، updated. استخدم * لإرجاع جميع الحقول بما في ذلك ratings_accuracy

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[importance]
enum<integer>

مستوى الأهمية الذي تتم التصفية بناءً عليه. يستخدم عامل "أكبر من أو يساوي" لمستوى الأهمية المحدد

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

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

parameters[updated]
integer

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

parameters[analyst_id]
string<csv>

معرّف محلّل واحد أو أكثر (analyst_id) تفصل بينها فواصل

parameters[firm_id]
string<csv>

معرّف شركة واحد أو أكثر (firm_id)، مفصولة بفواصل

parameters[action]
enum<string>

تصفية النتائج حسب action_company محدد (الإجراء الخاص بالتقييم). لاحظ أن جميع هذه المصطلحات محددة بدقة

الخيارات المتاحة:
Downgrades,
Maintains,
Reinstates,
Reiterates,
Upgrades,
Assumes,
Initiates Coverage On,
Terminates Coverage On,
Removes,
Suspends,
Firm Dissolved
analyst
string<csv>

قائمة من معرّفات المحللين (الأشخاص) مفصولة بفواصل لإرجاعها. إذا تم إغفالها سيتم إرجاع جميع المحللين المتاحين

firm
string<csv>

قائمة بمعرّفات شركات المحللين مفصولة بفواصل ليتم إرجاعها. في حال عدم تحديدها، سيتم إرجاع جميع الشركات المتاحة

simplify
boolean
افتراضي:false

بسّط التصنيفات إلى فئات معيارية موحّدة

الاستجابة

نجاح

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

ratings
object[]