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

# Analyst Estimates

`POST /v1/analyst-estimates/query`

Retrieves analyst financial estimates for a given symbol, including projected revenue,
earnings per share (EPS), and other key metrics, as forecasted by industry analysts.

## Request body

- PublicAnalystEstimatesQuery
  - `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[]
  - `period` 'annual' | 'quarter'
  - `limit` integer, nullable — Maximum number of analyst estimates to return. If omitted, all analyst estimates are returned.

## Response `200`

Successful Response

- PublicAnalystEstimatesResponse
  - `results` AnalystEstimates, required
    - `rp_entity_id` string, required — The RavenPack entity ID of the company.
    - `target_identifier_id` string, required — The target identifier ID of the company.
    - `fields` string[], required — The fields of the analyst estimates.
    - `values` array[], required — The values of the analyst estimates.
      - union[]
        - union
          - string
          - integer
          - number
  - `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)