Skip to main content
GET
/
api
/
v2.1
/
calendar
/
ratings
يُرجِع بيانات توصيات المحللين
curl --request GET \
  --url 'https://api.benzinga.com/api/v2.1/calendar/ratings?token=' \
  --header 'accept: <accept>'
{
  "ratings": [
    {}
  ]
}

Authorizations

​
token
string
query
required

Headers

​
accept
enum<string>
default:application/json
required

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

Available options:
application/json

Query Parameters

​
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
default: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>

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

Available options:
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 محدد (الإجراء الخاص بالتقييم). لاحظ أن جميع هذه المصطلحات محددة بدقة

Available options:
Downgrades,
Maintains,
Reinstates,
Reiterates,
Upgrades,
Assumes,
Initiates Coverage On,
Terminates Coverage On,
Removes,
Suspends,
Firm Dissolved
​
analyst
string<csv>

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

​
firm
string<csv>

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

​
simplify
boolean
default:false

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

Response

نجاح

​
ratings
object[]