Analyst Rating Distribution · MarketBeat

Look up MarketBeat analyst ratings with [company name]. Compare strong buy, buy, hold and sell opinions across the dates shown, alongside the total number of ratings. If several possible stocks appear, choose the one you mean before continuing.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Start with [company name] and use MarketBeat stock search to find possible matches. Results may include stocks, funds and articles. If the match is unclear, show the options and ask which stock the user means; do not choose the first result by default. Use the confirmed listing to look up ratings. Compare the dates, four opinion groups and total ratings. Keep missing information distinct from zero. Explain that this summarizes ratings MarketBeat covers and is not investment advice. Do not invent analyst details, targets, prices or forecasts, and follow existing authorization and budget.

Task:
Look up analyst ratings for [company name]. Compare strong buy, buy, hold and sell opinions across the dates shown, and include the total number of ratings for each date. Explain that these are ratings included on each date, not necessarily new ratings from that month.

Paste into your connected AI's conversation.

Connection guide

Up to 0.024 credits / call

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

MarketBeat

Analyst Rating Distribution · MarketBeat

You receive

Get dated aggregate rows of StrongBuy, Buy, Hold and Sell counts with TotalRatings for the stock you specify. Your Agent can compare the distribution across returned dates and, if useful, calculate each category’s share of the same row’s total. The dates identify aggregate views, rather than individual analyst rating events.

Start with your task

Look up analyst ratings for [company name]. Compare strong buy, buy, hold and sell opinions across the dates shown, and include the total number of ratings for each date. Explain that these are ratings included on each date, not necessarily new ratings from that month.

What to know

Coverage totals can change between dates. These are source-covered rating opinions, not trading instructions or a guarantee of future stock returns.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
queryParams`queryParams`	`object`	Required	Required fields `ticker`
Stock ticker`queryParams.ticker`	`string`	Required	Required stock ticker symbol, such as AAPL. Supply the symbol for the security you want to research; a company name is not the documented input.
Stock exchange`queryParams.exchange`	`string`	Optional	Optional exchange string, such as NYSE or NASDAQ. Supply it when known; the schema does not establish a default exchange for an omitted value.

View raw JSON

{
  "type": "object",
  "required": [
    "queryParams"
  ],
  "properties": {
    "queryParams": {
      "type": "object",
      "required": [
        "ticker"
      ],
      "properties": {
        "ticker": {
          "type": "string",
          "description": "Stock ticker symbol (e.g. 'AAPL')."
        },
        "exchange": {
          "type": "string",
          "description": "Stock exchange (e.g. 'NYSE', 'NASDAQ')."
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

No fixed output contract is available. Field types reflect saved result evidence; individual responses can differ.

Result schema
Field / Path	Type	Meaning
Dated rating distributions`result.data.items`	`array`	Collection of aggregate rating-count rows. Each row has a source date, four category counts and TotalRatings; it is not a list of individual analyst actions.
Source date`result.data.items[].Date`	`string`	Source calendar label for the distribution snapshot, not an individual rating-event timestamp. Preserve the reported date label.
Strong buy count`result.data.items[].StrongBuy`	`string`	Count assigned to the source StrongBuy category, returned as a string. It counts covered rating opinions rather than shares, targets or instructions to trade.
Buy count`result.data.items[].Buy`	`string`	String-encoded count in the source Buy category. Compare with the same row’s TotalRatings; a higher count alone does not establish a higher proportion.
Hold count`result.data.items[].Hold`	`string`	String-encoded count in the source Hold category. A returned zero is a count value, not missing information; retain it when comparing the distribution.
Sell count`result.data.items[].Sell`	`string`	String-encoded count in the source Sell category. The category label describes covered opinions and does not direct you to sell the stock.
Total ratings`result.data.items[].TotalRatings`	`string`	String-encoded total supplied for that row. Use it as the same-date denominator for derived shares; totals can change, and a missing or zero denominator must not be used for division.

Additional notes

MarketBeat’s methodology uses each covered analyst’s latest rating within the trailing 12 months. Its monthly recommendation chart shows distributions for that rolling window, rather than only that month’s new rating actions.

MarketBeat rating methodology and monthly recommendations chart

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

No. Compare the dates MarketBeat returns; you cannot choose a date range or an individual analyst.

Analyst Rating Distribution · MarketBeat

Analyst Rating Distribution · MarketBeat

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Start with the company name

Read the ratings by date

Compare with the total

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Start with the company name

Read the ratings by date

Compare with the total

Questions about this tool.

Can I choose a date range or one analyst?

Are the ratings shown all new for that month?

Does a higher number of buy ratings always mean opinions improved?

Does this include analyst names, price targets or today’s stock price?