Factset · Schema

consensusRatings

FinancialFinancial DataInvestment AnalyticsMarket DataPortfolio AnalyticsResearch

Properties

Name Type Description
fsymId string
estimateDate string Date of estimate expressed in YYYY-MM-DD format. For more details, visit [Online Assistant Page #16598](https://oa.apps.factset.com/pages/16598)
buyCount integer The number of Buy ratings taken into account in the calculation of a consensus. This information is shown only for a 100-day consensus.
overweightCount integer The number of Overweight ratings taken into account in the calculation of a consensus. This information is shown only for a 100-day consensus.
holdCount integer The number of Hold ratings taken into account in the calculation of a consensus. This information is shown only for a 100-day consensus.
underweightCount integer The number of Underweight ratings taken into account in the calculation of a consensus. This information is shown only for a 100-day consensus.
sellCount integer The number of Sell ratings taken into account in the calculation of a consensus. This information is shown only for a 100-day consensus.
ratingsNestTotal integer The total number of ratings taken into account in the calculation of a consensus. This information is shown only for a 100-day consensus.
ratingsNote number The mean average of ratings for the fiscal dates indicated, where each underlying rating is given a numerical score and then aggregated to a mean consensus - __*Individual Ratings Scores*__ |Value|Rat
ratingsNoteText string The mean textual rating for the fiscal dates indicated. The text rating is assigned by falling within the below defined ranges - __*Textual Ranges for Average*__ |Value|Rating Description| ||| |< 1.25
requestId string Identifier that was used for the request.
View JSON Schema on GitHub

JSON Schema

factset-estimates-consensus-ratings-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "consensusRatings",
  "type": "object",
  "properties": {
    "fsymId": {
      "type": "string"
    },
    "estimateDate": {
      "type": "string",
      "description": "Date of estimate expressed in YYYY-MM-DD format. For more details, visit [Online Assistant Page #16598](https://oa.apps.factset.com/pages/16598)"
    },
    "buyCount": {
      "type": "integer",
      "description": "The number of Buy ratings taken into account in the calculation of a consensus. This information is shown only for a 100-day consensus."
    },
    "overweightCount": {
      "type": "integer",
      "description": "The number of Overweight ratings taken into account in the calculation of a consensus. This information is shown only for a 100-day consensus."
    },
    "holdCount": {
      "type": "integer",
      "description": "The number of Hold ratings taken into account in the calculation of a consensus. This information is shown only for a 100-day consensus."
    },
    "underweightCount": {
      "type": "integer",
      "description": "The number of Underweight ratings taken into account in the calculation of a consensus. This information is shown only for a 100-day consensus."
    },
    "sellCount": {
      "type": "integer",
      "description": "The number of Sell ratings taken into account in the calculation of a consensus. This information is shown only for a 100-day consensus."
    },
    "ratingsNestTotal": {
      "type": "integer",
      "description": "The total number of ratings taken into account in the calculation of a consensus. This information is shown only for a 100-day consensus."
    },
    "ratingsNote": {
      "type": "number",
      "description": "The mean average of ratings for the fiscal dates indicated, where each underlying rating is given a numerical score and then aggregated to a mean consensus -\n__*Individual Ratings Scores*__\n|Value|Rating Description|\n|||\n|1|Buy|\n|1.5|Overweight|\n|2|Hold|\n|2.5|Underweight|\n|3|Sell|\n"
    },
    "ratingsNoteText": {
      "type": "string",
      "description": "The mean textual rating for the fiscal dates indicated. The text rating is assigned by falling within the below defined ranges - \n__*Textual Ranges for Average*__\n|Value|Rating Description|\n|||\n|< 1.25|Buy|\n|< 1.75|Overweight|\n|< 2.25|Hold|\n|< 2.75|Underweight|\n|<= 3|Sell|\n"
    },
    "requestId": {
      "type": "string",
      "description": "Identifier that was used for the request."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/factset-estimates-consensus-ratings"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.