---
title: "Analyst Ratings"
method: POST
path: "/v1/analyst-ratings/query"
tags: ["Analyst Estimates"]
---

# Analyst Ratings

`POST /v1/analyst-ratings/query`

Retrieves analyst ratings and recommendations for a given symbol, including
buy/hold/sell counts and the consensus recommendations.

## Request body

- AnalystRatingsQuery
  - `identifier` Identifier, required
    - `type` 'rp_entity_id', required
    - `value` union, required — Bigdata uses the RavenPack Entity identifier (RP_Entity_ID) to uniquely reference entities such as companies. This identifier is a 6-character alphanumeric code (letters and numbers only). Example: Alphabet Inc. (`4A6F00`)
      - string
      - string[]

## Response `200`

Successful Response

- AnalystRatingsResponse
  - `results` AnalystRatings[], required
    - `rp_entity_id` string, required — RavenPack internal entity identifier.
    - `target_identifier_id` string, required — The target identifier provided in the request, e.g., stock symbol.
    - `strong_buy` integer, nullable — Number of analysts who have issued a 'Strong Buy' recommendation for the stock.
    - `buy` integer, nullable — Number of analysts who have issued a 'Buy' rating.
    - `hold` integer, nullable — Number of analysts recommending to hold the stock.
    - `sell` integer, nullable — Number of analysts recommending to sell the stock.
    - `strong_sell` integer, nullable — Number of analysts recommending a 'Strong Sell'.
    - `consensus` 'Strong Buy' | 'Buy' | 'Hold' | 'Sell' | 'Strong Sell' — Enum for the consensus rating of analysts.
  - `errors` ErrorDetail[], nullable
    - `message` string, nullable
  - `metadata` Metadata
    - `request_id` string, required
    - `timestamp` string

---

[API](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api.md) · [All operations](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bigdata/bigdata-structured-data-api/revisions/18082de268c4/schema)