Skip to main content
GET
/
api
/
v2.1
/
calendar
/
ratings
Devuelve datos de las recomendaciones de analistas
curl --request GET \
  --url 'https://api.benzinga.com/api/v2.1/calendar/ratings?token=' \
  --header 'accept: <accept>'
{
  "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",
      "cusip": 37833100,
      "date": "2024-01-09T00:00:00.000Z",
      "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"
    }
  ]
}

Authorizations

​
token
string
query
required

Headers

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

Especifica el formato de respuesta. Los parámetros de consulta funcionan igual para ambos formatos.

Available options:
application/json

Query Parameters

​
fields
string<csv>

Lista de campos separados por comas que se deben devolver. Campos disponibles: 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. Utilice * para todos los campos, incluido ratings_accuracy.

​
page
integer
default:0

Desplazamiento de página. Por motivos de optimización, rendimiento y técnicos, los desplazamientos de página están limitados entre 0 y 100000. Limite los resultados de la consulta usando otros parámetros, como la fecha.

​
pagesize
integer

Cantidad de resultados devueltos. Límite: 1000

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

Fecha para consultar datos del calendar. Equivalente abreviado de date_from y date_to si son iguales. De forma predeterminada, consulta la más reciente.

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

Fecha desde la cual realizar la consulta

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

Fecha hasta la que se consulta el punto en el tiempo

​
parameters[importance]
enum<integer>

El nivel de importancia por el que filtrar. Utiliza un valor mayor o igual que el nivel de importancia indicado

Available options:
0,
1,
2,
3,
4,
5
​
parameters[tickers]
string<csv>

Uno o más símbolos de ticker separados por comas. Máximo 50 símbolos de ticker

​
parameters[updated]
integer

Marca de tiempo Unix (UTC) de la última actualización de los registros. Esto forzará que el orden de clasificación sea mayor o igual que la marca de tiempo indicada

​
parameters[analyst_id]
string<csv>

Uno o más IDs de analista (analyst_id) separados por comas

​
parameters[firm_id]
string<csv>

Uno o más IDs de firma (firm_id) separados por comas

​
parameters[action]
enum<string>

Filtra por un action_company específico (acción de rating). Ten en cuenta que todos estos términos están definidos con precisión

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

Lista de ID de analistas (personas), separados por comas, que se devolverán. Si se omite, se devolverán todos los analistas disponibles

​
firm
string<csv>

Lista de identificadores de firmas de analistas separados por comas que se devolverán. Si se omite, se devolverán todas las firmas disponibles

​
simplify
boolean
default:false

Simplifica las calificaciones a categorías estandarizadas

Response

éxito

Respuesta de la API que contiene una matriz de calificaciones de analistas

​
ratings
object[]