# Yahoo API: Get analyst ratings

> Shows analyst recommendations, price targets, earnings estimates and recent rating changes for a public company on Yahoo Finance.

Unofficial. Not affiliated with or endorsed by Yahoo.

- Page: https://fous.com/methods/finance.yahoo.com/get-analyst-ratings
- Method: `finance.yahoo.com/get_analyst_ratings`, version 1
- Website: finance.yahoo.com
- Returns: consensus rating, analyst counts, price targets, earnings and revenue estimates, recent rating changes
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `company` | string | yes | `"Nvidia"` | Company name or stock ticker, for example Nvidia or NVDA. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "company": "Nvidia"
}
```

Its output:

```json
{
  "ticker": "NVDA",
  "currency": "USD",
  "buy_count": 49,
  "page_link": "https://finance.yahoo.com/quote/NVDA/analysis/",
  "hold_count": 2,
  "sell_count": 1,
  "company_name": "NVIDIA Corporation",
  "current_price": 212.21,
  "consensus_rating": "Strong Buy",
  "low_price_target": 180,
  "strong_buy_count": 10,
  "high_price_target": 515,
  "strong_sell_count": 0,
  "next_earnings_date": "2026-11-17",
  "number_of_analysts": 58,
  "median_price_target": 315,
  "average_price_target": 328.95346,
  "recent_rating_changes": [
    {
      "date": "2026-10-22",
      "firm": "Needham",
      "action": "Reiterates",
      "to_rating": "Buy",
      "from_rating": "Buy",
      "price_target": 300
    },
    {
      "date": "2026-10-01",
      "firm": "Cantor Fitzgerald",
      "action": "Reiterates",
      "to_rating": "Overweight",
      "from_rating": "Overweight",
      "price_target": 350
    },
    {
      "date": "2026-09-29",
      "firm": "Rosenblatt",
      "action": "Maintains",
      "to_rating": "Buy",
      "from_rating": "Buy",
      "price_target": 390
    }
  ],
  "current_year_eps_estimate": 9.31242,
  "mean_recommendation_score": 1.29032,
  "current_quarter_eps_estimate": 2.47325,
  "current_year_revenue_estimate": 411653417250,
  "current_quarter_revenue_estimate": 108976833310
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"finance.yahoo.com/get_analyst_ratings","input":{"company":"Nvidia"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What is the consensus analyst rating for NVDA and how many analysts cover it?
- Show me the latest price targets analysts have set for Tesla
- Can you pull up the earnings and revenue estimates for Apple for the next quarter?
- Which analysts recently upgraded or downgraded Microsoft stock?
- On Yahoo Finance, what are the analyst recommendations and high versus low price targets for Amazon?

## Input schema

```json
{
  "type": "object",
  "required": [
    "company"
  ],
  "properties": {
    "company": {
      "type": "string",
      "minLength": 1,
      "description": "Company name or stock ticker, for example Nvidia or NVDA."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "company_name",
    "ticker",
    "currency",
    "current_price",
    "consensus_rating",
    "number_of_analysts",
    "strong_buy_count",
    "buy_count",
    "hold_count",
    "sell_count",
    "strong_sell_count",
    "average_price_target",
    "median_price_target",
    "low_price_target",
    "high_price_target",
    "next_earnings_date",
    "current_quarter_eps_estimate",
    "current_year_eps_estimate",
    "current_quarter_revenue_estimate",
    "current_year_revenue_estimate",
    "recent_rating_changes",
    "mean_recommendation_score",
    "page_link"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Stock ticker."
    },
    "currency": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO currency code for prices and targets."
    },
    "buy_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Analysts with a buy rating this month."
    },
    "page_link": {
      "type": "string",
      "description": "Yahoo Finance analysis page for this company."
    },
    "hold_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Analysts with a hold rating this month."
    },
    "sell_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Analysts with a sell rating this month."
    },
    "company_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Company name on Yahoo Finance."
    },
    "current_price": {
      "type": [
        "number",
        "null"
      ],
      "description": "Latest regular-market share price in the stated currency."
    },
    "consensus_rating": {
      "type": [
        "string",
        "null"
      ],
      "description": "Overall recommendation: Strong Buy, Buy, Hold, Underperform, or Sell."
    },
    "low_price_target": {
      "type": [
        "number",
        "null"
      ],
      "description": "Lowest analyst price target per share in the stated currency."
    },
    "strong_buy_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Analysts with a strong buy rating this month."
    },
    "high_price_target": {
      "type": [
        "number",
        "null"
      ],
      "description": "Highest analyst price target per share in the stated currency."
    },
    "strong_sell_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Analysts with a strong sell rating this month."
    },
    "next_earnings_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Next scheduled earnings report date, if Yahoo shows one."
    },
    "number_of_analysts": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Number of analyst opinions for the consensus."
    },
    "median_price_target": {
      "type": [
        "number",
        "null"
      ],
      "description": "Median analyst price target per share in the stated currency."
    },
    "average_price_target": {
      "type": [
        "number",
        "null"
      ],
      "description": "Average analyst price target per share in the stated currency."
    },
    "recent_rating_changes": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "date",
          "firm",
          "action",
          "from_rating",
          "to_rating",
          "price_target"
        ],
        "properties": {
          "date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "firm": {
            "type": [
              "string",
              "null"
            ]
          },
          "action": {
            "type": [
              "string",
              "null"
            ]
          },
          "to_rating": {
            "type": [
              "string",
              "null"
            ]
          },
          "from_rating": {
            "type": [
              "string",
              "null"
            ]
          },
          "price_target": {
            "type": [
              "number",
              "null"
            ],
            "description": "New price target per share in the stated currency, if shown."
          }
        },
        "additionalProperties": false
      },
      "description": "Up to 10 most recent analyst rating actions, newest first."
    },
    "current_year_eps_estimate": {
      "type": [
        "number",
        "null"
      ],
      "description": "Average earnings per share estimate for the current fiscal year."
    },
    "mean_recommendation_score": {
      "type": [
        "number",
        "null"
      ],
      "description": "Mean analyst recommendation score; 1 is strongest buy and 5 is sell.",
      "x-fous-developer": true
    },
    "current_quarter_eps_estimate": {
      "type": [
        "number",
        "null"
      ],
      "description": "Average earnings per share estimate for the current quarter."
    },
    "current_year_revenue_estimate": {
      "type": [
        "number",
        "null"
      ],
      "description": "Average revenue estimate for the current fiscal year in the stated currency."
    },
    "current_quarter_revenue_estimate": {
      "type": [
        "number",
        "null"
      ],
      "description": "Average revenue estimate for the current quarter in the stated currency."
    }
  },
  "additionalProperties": false
}
```

## See more

- [Yahoo API: Get company news](https://fous.com/methods/finance.yahoo.com/get-company-news.md): Looks up a company by name or ticker on Yahoo Finance and returns its latest news headlines, with article summaries when the article page provides one.
- [Yahoo API: Get earnings calendar](https://fous.com/methods/finance.yahoo.com/get-earnings-calendar.md): Gets earnings reports for a date range, or the upcoming reports and up to four previous reports for one company.
- [Yahoo API: Get quote](https://fous.com/methods/finance.yahoo.com/get-quote.md): Looks up a stock, fund, index, or cryptocurrency by name or ticker and returns its latest displayed price and key statistics. Unavailable figures are null; quotes may be delayed.
- [Yahoo API: List market movers](https://fous.com/methods/finance.yahoo.com/list-market-movers.md): Lists Yahoo Finance's top gainers, top losers, most active stocks, or regional trending tickers in Yahoo's order, with price, change, volume and market cap.
- [Yahoo API: Get price history](https://fous.com/methods/finance.yahoo.com/get-price-history.md): Returns Yahoo Finance daily, weekly or monthly price history and total adjusted-close return for a stock, fund, index or cryptocurrency.
- [Yahoo API: Get player stats](https://fous.com/methods/sports.yahoo.com/get-player-stats.md): Looks up a Yahoo Sports player by name and returns the player's regular-season statistics for a season, alongside career totals. Each stat includes season and career values.
- [Yahoo API: Search Yahoo News](https://fous.com/methods/yahoo.com/search-news.md): Searches Yahoo News articles by keyword, newest first or by relevance, with optional publication dates and pages; returns only articles hosted on Yahoo News, with authors, original publisher and section.
- [Yahoo API: List Yahoo News headlines](https://fous.com/methods/yahoo.com/list-headlines.md): Lists the latest Yahoo News headlines for a section in page order, with summary, byline, original publisher, image and publication time when the article provides them.
- [All Yahoo methods](https://fous.com/methods/yahoo.com.md)