合作方数据分析师评级 · REST 接口

分析师评级。获取结构化的历史分析师评级，包括评级动作、目标价变动与机构名称。每条记录包含评级日期、动作类型（如下调、维持）与发布机构，并附可选的目标价变动与超预期指标。可按代码、机构、评级动作与日期区间过滤；目标价可选地按拆合股、分红等公司行动做调整。记录带时间戳且可排序。

GET /benzinga/v1/ratings

上游时效说明

实时更新

上游历史范围

数据可追溯至 2011 年 12 月 8 日

适用场景

市场情绪跟踪、组合预警、评级影响回测、趋势分析。

接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例，文档收录不等于本站已开放全部能力。

查询参数

参数	类型	必填	说明
`date`	string	No	评级发布日（格式 YYYY-MM-DD）。
`date.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`date.gt`	string	No	筛选大于该值。
`date.gte`	string	No	筛选大于或等于该值。
`date.lt`	string	No	筛选小于该值。
`date.lte`	string	No	筛选小于或等于该值。
`ticker`	string	No	被评级公司的股票代码。
`ticker.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`ticker.gt`	string	No	筛选大于该值。
`ticker.gte`	string	No	筛选大于或等于该值。
`ticker.lt`	string	No	筛选小于该值。
`ticker.lte`	string	No	筛选小于或等于该值。
`importance`	integer	No	财报事件重要性的主观指标，取值 0（最低）到 5（最高）。值必须为整数。
`importance.gt`	integer	No	筛选大于该值。值必须为整数。
`importance.gte`	integer	No	筛选大于或等于该值。值必须为整数。
`importance.lt`	integer	No	筛选小于该值。值必须为整数。
`importance.lte`	integer	No	筛选小于或等于该值。值必须为整数。
`last_updated`	string	No	该评级在系统中最后一次更新的时间戳（ISO 8601 格式）。值须为以秒为单位的整数时间戳、yyyy-mm-dd 格式的日期，或 ISO 8601 / RFC 3339 格式（例如 2024-05-28T20:27:41Z）。
`last_updated.gt`	string	No	筛选大于该值。值须为以秒为单位的整数时间戳、yyyy-mm-dd 格式的日期，或 ISO 8601 / RFC 3339 格式（例如 2024-05-28T20:27:41Z）。
`last_updated.gte`	string	No	筛选大于或等于该值。值须为以秒为单位的整数时间戳、yyyy-mm-dd 格式的日期，或 ISO 8601 / RFC 3339 格式（例如 2024-05-28T20:27:41Z）。
`last_updated.lt`	string	No	筛选小于该值。值须为以秒为单位的整数时间戳、yyyy-mm-dd 格式的日期，或 ISO 8601 / RFC 3339 格式（例如 2024-05-28T20:27:41Z）。
`last_updated.lte`	string	No	筛选小于或等于该值。值须为以秒为单位的整数时间戳、yyyy-mm-dd 格式的日期，或 ISO 8601 / RFC 3339 格式（例如 2024-05-28T20:27:41Z）。
`rating_action`	string	No	相对该机构上次评级的变动说明。可能取值包括 downgrades、maintains、reinstates、reiterates、upgrades、assumes、initiates_coverage_on、terminates_coverage_on、removes、suspends、firm_dissolved。
`rating_action.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`rating_action.gt`	string	No	筛选大于该值。
`rating_action.gte`	string	No	筛选大于或等于该值。
`rating_action.lt`	string	No	筛选小于该值。
`rating_action.lte`	string	No	筛选小于或等于该值。
`price_target_action`	string	No	目标价变动方向的说明。可选值包括：raises、lowers、maintains、announces、sets。
`price_target_action.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`price_target_action.gt`	string	No	筛选大于该值。
`price_target_action.gte`	string	No	筛选大于或等于该值。
`price_target_action.lt`	string	No	筛选小于该值。
`price_target_action.lte`	string	No	筛选小于或等于该值。
`benzinga_id`	string	No	Benzinga 为该记录分配的标识。
`benzinga_id.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`benzinga_id.gt`	string	No	筛选大于该值。
`benzinga_id.gte`	string	No	筛选大于或等于该值。
`benzinga_id.lt`	string	No	筛选小于该值。
`benzinga_id.lte`	string	No	筛选小于或等于该值。
`benzinga_analyst_id`	string	No	Benzinga 用于该分析师的标识。
`benzinga_analyst_id.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`benzinga_analyst_id.gt`	string	No	筛选大于该值。
`benzinga_analyst_id.gte`	string	No	筛选大于或等于该值。
`benzinga_analyst_id.lt`	string	No	筛选小于该值。
`benzinga_analyst_id.lte`	string	No	筛选小于或等于该值。
`benzinga_firm_id`	string	No	Benzinga 用于该机构的标识。
`benzinga_firm_id.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`benzinga_firm_id.gt`	string	No	筛选大于该值。
`benzinga_firm_id.gte`	string	No	筛选大于或等于该值。
`benzinga_firm_id.lt`	string	No	筛选小于该值。
`benzinga_firm_id.lte`	string	No	筛选小于或等于该值。
`limit`	integer	No	限制返回结果的最大数量。未指定时默认为 100，允许的最大值为 50000。
`sort`	string	No	逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 last_updated，排序方向默认为 desc。

响应字段

字段	类型	说明
`next_url`	string	若存在，可用该值获取下一页数据。
`request_id`	string	服务器分配的请求 ID。
`results`	array[object]	本次请求的结果。
`results[].adjusted_price_target`	number	按拆合股与分红调整后的当前目标价。
`results[].analyst`	string	发布该评级的分析师姓名。
`results[].benzinga_analyst_id`	string	Benzinga 用于该分析师的标识。
`results[].benzinga_calendar_url`	string	该标的在 Benzinga 日历页的链接。
`results[].benzinga_firm_id`	string	Benzinga 用于该机构的标识。
`results[].benzinga_id`	string	Benzinga 为该记录分配的标识。
`results[].benzinga_news_url`	string	该标的在 Benzinga 文章页的链接。
`results[].company_name`	string	被评级公司的名称。
`results[].currency`	string	目标价的计价货币，ISO 4217 代码。
`results[].date`	string	评级发布日（格式 YYYY-MM-DD）。
`results[].firm`	string	发布该评级的研究机构或投资银行名称。
`results[].importance`	integer	财报事件重要性的主观指标，取值 0（最低）到 5（最高）。
`results[].last_updated`	string	该评级在系统中最后一次更新的时间戳（ISO 8601 格式）。
`results[].notes`	string	补充的背景说明或评论。
`results[].previous_adjusted_price_target`	number	按拆合股与分红调整后的上次目标价。
`results[].previous_price_target`	number	分析师设定的上次目标价。
`results[].previous_rating`	string	分析师给出的上次评级。
`results[].price_percent_change`	number	目标价的变动百分比，在当前目标价与上次目标价均存在时给出。
`results[].price_target`	number	分析师设定的当前目标价。
`results[].price_target_action`	string	目标价变动方向的说明。可选值包括：raises、lowers、maintains、announces、sets。
`results[].rating`	string	分析师给出的当前评级。
`results[].rating_action`	string	相对该机构上次评级的变动说明。可能取值包括 downgrades、maintains、reinstates、reiterates、upgrades、assumes、initiates_coverage_on、terminates_coverage_on、removes、suspends、firm_dissolved。
`results[].ticker`	string	被评级公司的股票代码。
`results[].time`	string	评级发布的时间（24 小时制 HH:MM:SS，UTC）。
`status`	enum: OK	本次请求响应的状态。

响应示例

{
  "count": 1,
  "request_id": 1,
  "results": [
    {
      "adjusted_price_target": 15,
      "analyst": "Alexander Potter",
      "benzinga_analyst_id": "58933b2043eaaa0001698f4a",
      "benzinga_calendar_url": "https://www.benzinga.com/quote/RIVN/analyst-ratings",
      "benzinga_firm_id": "5e147c6b7da4190001b287b4",
      "benzinga_id": "682f29b0e5343b000100a619",
      "benzinga_news_url": "https://www.benzinga.com/stock-articles/RIVN/analyst-ratings",
      "company_name": "Rivian Automotive",
      "currency": "USD",
      "date": "2025-05-22",
      "firm": "Piper Sandler",
      "importance": 0,
      "last_updated": "2025-05-22T13:42:30Z",
      "previous_adjusted_price_target": 13,
      "previous_price_target": 13,
      "previous_rating": "neutral",
      "price_percent_change": 15.38,
      "price_target": 15,
      "price_target_action": "raises",
      "rating": "neutral",
      "rating_action": "maintains",
      "ticker": "RIVN",
      "time": "09:42:08"
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗

合作方数据 分析师评级 · REST 接口

适用场景

查询参数

响应字段

响应示例

合作方数据分析师评级 · REST 接口