Sign in

v1

latestOpenAPI 3.0.02026-07-266091181.5 KB
ratings

Returns analyst ratings data

Returns analyst ratings data including upgrades, downgrades, initiations, and price target changes from Wall Street analysts. Includes current and prior ratings, price targets, analyst information, and ratings accuracy metrics when available.

get/api/v2.1/calendar/ratings

Query parameters

fieldsstring csv

Comma-separated list of fields to return. Available fields: 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. Use * for all fields including ratings_accuracy

pageinteger

Page offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date

pagesizeinteger

Number of results returned. Limit 1000

parameters[date]string YYYY-MM-DD

Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest

parameters[date_from]string YYYY-MM-DD

Date to query from point in time

parameters[date_to]string YYYY-MM-DD

Date to query to point in time

parameters[importance]0 | 1 | 2 | 3 | 4 | 5

The importance level to filter by. Uses Greater Than or Equal To the importance indicated

parameters[tickers]string csv

One or more ticker symbols separated by a comma. Maximum 50 tickers

parameters[updated]integer

Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated

parameters[analyst_id]string csv

One or more analyst ids (analyst_id) separated by a comma

parameters[firm_id]string csv

One or more firm ids (firm_id) separated by a comma

parameters[action]'Downgrades' | 'Maintains' | 'Reinstates' | 'Reiterates' | 'Upgrades' | 'Assumes' | 'Initiates Coverage On' | 'Terminates Coverage On' | 'Removes' | 'Suspends' | 'Firm Dissolved'

Filter by a specific action_company (action for rating). Note that all of these terms are precisely defined

analyststring csv

A comma separated list of analyst (person) ID's to bring back. Omitting will bring back all available analysts

firmstring csv

A comma separated list of analyst firm ID's to bring back. Omitting will bring back all available firms

simplifyboolean

Simplify the ratings to standardized categories

Headers

accept'application/json' required

Specifies return format. Query parameters work the same for both formats

Response

success

Example response

{
  "ratings": [
    {
      "action_company": "Goldman Sachs",
      "action_pt": "Raises",
      "adjusted_pt_current": "200.00",
      "adjusted_pt_prior": "185.00",
      "analyst": "Goldman Sachs",
      "analyst_id": "60a7f5e8e4b0f5a3c8e9f5a6",
      "analyst_name": "John Smith",
      "currency": "USD",
      "date": "2024-01-09",
      "exchange": "NASDAQ",
      "firm_id": "60a7f5e8e4b0f5a3c8e9f5a5",
      "id": "60a7f5e8e4b0f5a3c8e9f5a4",
      "importance": 3,
      "isin": "US0378331005",
      "name": "Apple Inc.",
      "notes": "Upgraded due to strong quarterly performance",
      "pt_current": "200.00",
      "pt_prior": "185.00",
      "rating_current": "Buy",
      "rating_prior": "Neutral",
      "ticker": "AAPL",
      "time": "09:30:00",
      "updated": 1704819600,
      "url": "https://www.benzinga.com/ratings/123456",
      "url_calendar": "https://www.benzinga.com/calendar/ratings/123456",
      "url_news": "https://www.benzinga.com/news/123456"
    }
  ]
}