> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/yahoo-finance/instruments-symbol-analyst>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/yahoo-finance/instruments-symbol-analyst.mdx>

---

# Yahoo Finance Analyst API

Ratings, upgrades, downgrades and price targets for one ticker.

`GET /v1/yahoo-finance/instruments/{symbol}/analyst` returns `data.recommendationTrend`, `data.upgradeDowngradeHistory`, `data.financialData` and `data.insights`. The trend rows carry `period`, `strongBuy`, `buy`, `hold`, `sell` and `strongSell`. Upgrade and downgrade rows carry `firm`, `toGrade`, `fromGrade`, `action` and `epochGradeDate` as an ISO 8601 UTC time. The financial data section carries `targetMeanPrice`, `targetHighPrice`, `targetLowPrice`, `targetMedianPrice`, `numberOfAnalystOpinions`, `recommendationMean` and `recommendationKey`.

`data.insights` is the recommendation record (`targetPrice`, `provider`, `rating`) from the insights route, when available. It can be null while the rest of the response is found. Analyst research-report metadata is available on the insights route.

## Request

- **Endpoint:** `GET /v1/yahoo-finance/instruments/{symbol}/analyst`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by ticker
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/yahoo-finance/instruments/symbol/analyst/get)
- **Platform page:** [/platforms/yahoo-finance](https://www.socialfetch.dev/platforms/yahoo-finance)

## FAQ

### What does the recommendation trend show?

One row per period with the count of strongBuy, buy, hold, sell and strongSell ratings, so you can see how the analyst mix changed over time.

### Where are the price targets?

In data.financialData: targetMeanPrice, targetHighPrice, targetLowPrice, targetMedianPrice and numberOfAnalystOpinions, when available.

### What is in data.insights?

The recommendation record from the insights route, with the rating, provider and target when available. It is null if that optional call did not answer.

### How many credits does this route cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.