الانتقال إلى المحتوى الرئيسي
GET
/
api
/
v1
/
consensus-ratings
يُرجِع بيانات إجماع تصنيفات المحللين
curl --request GET \
  --url 'https://api.benzinga.com/api/v1/consensus-ratings?token=' \
  --header 'accept: <accept>'
{
  "aggregate_ratings": {
    "strong_buy": 7,
    "buy": 12,
    "hold": 5,
    "sell": 2
  },
  "aggregate_type": "number",
  "low_price_target": 200,
  "high_price_target": 350,
  "consensus_price_target": 293.69192307692305,
  "consensus_rating_val": 3.923076923076923,
  "consensus_rating": "BUY",
  "updated_at": "2026-01-05T19:42:36Z",
  "total_analyst_count": 50,
  "unique_analyst_count": 26
}

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.

{
  "aggregate_ratings": {
    "strong_buy": 7,
    "buy": 12,
    "hold": 5,
    "sell": 2
  },
  "aggregate_type": "number",
  "low_price_target": 200,
  "high_price_target": 350,
  "consensus_price_target": 293.69192307692305,
  "consensus_rating_val": 3.923076923076923,
  "consensus_rating": "BUY",
  "updated_at": "2026-01-05T19:42:36Z",
  "total_analyst_count": 50,
  "unique_analyst_count": 26
}

التفويضات

​
token
string
query
مطلوب

الترويسات

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

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

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

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

​
pagesize
integer

عدد النتائج المُرتجَعة. الحد الأقصى 1000

​
parameters[date_from]
string<YYYY-MM-DD>

تاريخ بدء الاستعلام من نقطة زمنية معينة

​
parameters[date_to]
string<YYYY-MM-DD>

تاريخ تنفيذ الاستعلام حتى نقطة زمنية معيّنة

​
parameters[tickers]
string

رمز تداول واحد للاستعلام عن البيانات المجمّعة له. الحد الأقصى رمز تداول واحد

​
simplify
boolean
افتراضي:false

لتبسيط التصنيفات المجمَّعة إلى BUY وSELL وHOLD فقط، فإن السلوك الافتراضي سيُرجِع جميع التصنيفات (STRONG_BUY, BUY, HOLD, SELL, STRONG_SELL)

​
aggregate_type
enum<string>
افتراضي:number

لتجميع التقييمات إما حسب العدد أو حسب النسبة المئوية

الخيارات المتاحة:
number,
percentage

الاستجابة

نجاح

​
aggregate_ratings
object
​
aggregate_type
string
مثال:

"90D"

​
consensus_price_target
number
مثال:

195.5

​
consensus_rating
string
مثال:

"Buy"

​
consensus_rating_val
number
مثال:

4.2

​
high_price_target
number
مثال:

225

​
low_price_target
number
مثال:

150

​
total_analyst_count
integer
مثال:

19

​
unique_analyst_count
integer
مثال:

15

​
updated_at
string
مثال:

"2024-01-09T16:00:00.000Z"