> ## Documentation Index > Fetch the complete documentation index at: https://docs.bigdata.com/llms.txt > Use this file to discover all available pages before exploring further. # Analyst Estimates > Retrieves analyst financial estimates for a given symbol, including projected revenue, earnings per share (EPS), and other key metrics, as forecasted by industry analysts. Each request returns estimates for one company. The `results.values` array is ordered with the furthest-future forecasted period first, working backward to the oldest period returned. Forward-looking forecasts and past periods sit on the same timeline, so how much history and how far ahead analysts forecast varies by company. Coverage is densest for the next two to three years and thins out beyond that. Filtering by date range is not supported. Use `period` to choose annual or quarterly estimates and `limit` to control how many periods are returned. ## OpenAPI ````yaml /api-rest/openapi/openapi_structured_data.json post /v1/analyst-estimates/query openapi: 3.1.0 info: title: Bigdata Structured Data API description: Bigdata API documentation version: 1.0.0 servers: - url: https://api.bigdata.com/ security: - ApiKeyAuth: [] tags: - name: Market Data description: >- Market data endpoints including intraday prices, daily prices, price changes, and real-time quotes - name: Analyst Estimates description: >- Analyst estimates and ratings including analyst ratings, estimates, target prices, and earnings surprises - name: Financials & Ratios description: >- Financial statements and ratios including balance sheet, income statement, cash flow statement, key metrics TTM, and company ratios TTM - name: Company & Events description: >- Company information and events including company profile and events calendar - name: Fund Holdings description: >- Institutional fund holdings from SEC 13F filings including fund holdings and stock fund holdings - name: Knowledge Graph description: Corporate ownership and hierarchy data. - name: Private Markets description: >- Private company data including profile, headquarters, funding totals and valuation - name: Fixed Income description: 'Bond reference data: the bonds a company has issued and their terms' paths: /v1/analyst-estimates/query: post: tags: - Analyst Estimates summary: Analyst Estimates description: >- Retrieves analyst financial estimates for a given symbol, including projected revenue, earnings per share (EPS), and other key metrics, as forecasted by industry analysts. Each request returns estimates for one company. The `results.values` array is ordered with the furthest-future forecasted period first, working backward to the oldest period returned. Forward-looking forecasts and past periods sit on the same timeline, so how much history and how far ahead analysts forecast varies by company. Coverage is densest for the next two to three years and thins out beyond that. Filtering by date range is not supported. Use `period` to choose annual or quarterly estimates and `limit` to control how many periods are returned. operationId: query_analyst_estimates_v1_analyst_estimates_query_post requestBody: content: application/json: schema: $ref: '#/components/schemas/PublicAnalystEstimatesQuery' required: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PublicAnalystEstimatesResponse' components: schemas: PublicAnalystEstimatesQuery: properties: identifier: $ref: '#/components/schemas/Identifier' description: >- Object specifying which identifier you are using to request the analyst estimates. You must supply one type and its corresponding value. period: $ref: '#/components/schemas/AllowedPeriods' description: >- Select whether the estimates to be provided are on an annual or quarterly basis. default: quarter examples: - annual limit: anyOf: - type: integer - type: 'null' title: Limit description: >- Maximum number of analyst estimates to return, starting from the furthest-future forecasted period available and working backwards. If omitted, defaults to 20. Values above 200 are rejected. default: 20 examples: - 20 type: object required: - identifier title: PublicAnalystEstimatesQuery PublicAnalystEstimatesResponse: properties: results: $ref: '#/components/schemas/AnalystEstimates' errors: anyOf: - items: $ref: '#/components/schemas/ErrorDetail' type: array - type: 'null' title: Errors metadata: anyOf: - $ref: '#/components/schemas/Metadata' - type: 'null' sources: items: $ref: '#/components/schemas/Source' type: array title: Sources description: >- The content catalog sources the response was built from, one entry per source. Empty when no catalog source contributed. usage: anyOf: - $ref: '#/components/schemas/Usage' - type: 'null' description: >- Tokens the request consumed, per content tier. Present only for API keys billed in tokens. type: object required: - results title: PublicAnalystEstimatesResponse Identifier: properties: type: $ref: '#/components/schemas/IdentifierType' description: >- The identifier namespace. Currently only `rp_entity_id` is supported. default: rp_entity_id examples: - rp_entity_id value: anyOf: - type: string - items: type: string type: array title: Value description: >- 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`) examples: - 4A6F00 type: object required: - type - value title: Identifier AllowedPeriods: type: string enum: - annual - quarter title: AllowedPeriods AnalystEstimates: properties: rp_entity_id: type: string title: Rp Entity Id description: The RavenPack entity ID of the company. examples: - 4A6F00 target_identifier_id: type: string title: Target Identifier Id description: The target identifier ID of the company. examples: - GOOGL fields: items: type: string type: array title: Fields description: The fields of the analyst estimates. examples: - - FISCAL_PERIOD_END_DATE - REVENUE_LOW - REVENUE_HIGH - REVENUE_AVG - EBITDA_LOW - EBITDA_HIGH - EBITDA_AVG - EBIT_LOW - EBIT_HIGH - EBIT_AVG - NET_INCOME_LOW - NET_INCOME_HIGH - NET_INCOME_AVG - SGA_EXPENSE_LOW - SGA_EXPENSE_HIGH - SGA_EXPENSE_AVG - EPS_LOW - EPS_HIGH - EPS_AVG - NUM_ANALYSTS_REVENUE - NUM_ANALYSTS_EPS values: items: items: anyOf: - type: string - type: integer - type: number type: array type: array title: Values description: The values of the analyst estimates. examples: - - '2025-12-31' - 387588929898 - 399321530206 - 394966067919 - 135473353787 - 139574231263 - 138051873327 - 115816555170 - 119322406979 - 118020938853 - 118458970299 - 126884966950 - 121111982610 - 55347517673 - 57022927502 - 56400969528 - 9.94514 - 10.19402 - 9.51707 - 42 - 47 type: object required: - rp_entity_id - target_identifier_id - fields - values title: AnalystEstimates ErrorDetail: properties: message: anyOf: - type: string - type: 'null' title: Message type: object title: ErrorDetail Metadata: properties: request_id: type: string title: Request Id timestamp: type: string title: Timestamp type: object required: - request_id title: Metadata Source: properties: id: type: string title: Id description: Content catalog identifier of the source. examples: - CA9FA3 name: type: string title: Name description: Catalog name of the dataset the data came from. examples: - Corporate Fundamentals type: object required: - id - name title: Source description: >- A content catalog source that contributed data to a structured-data response. Usage: additionalProperties: type: integer type: object title: Usage description: >- Public structured-data usage for a request, aggregated per content tier. A flat object keyed per content tier, where each key is derived from the content tier identifier by dropping the ``content-`` prefix and appending ``_tokens`` (e.g. ``corporate-fundamentals`` -> ``corporate_fundamentals_tokens``). It is sparse: only tiers with non-zero tokens appear, and an absent key means zero tokens for that tier. IdentifierType: type: string enum: - rp_entity_id title: IdentifierType default: rp_entity_id securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-KEY ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.