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

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

التفويضات

​
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

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

الاستجابة

نجاح

​
ratings
object[]