> **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/screeners>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/yahoo-finance/screeners.mdx>

---

# Yahoo Finance Screeners API

The predefined screener catalogue, so you can pick an id to request.

`GET /v1/yahoo-finance/screeners` returns `data.screeners` and `data.count`. Each row carries `id`, `canonicalName`, `title`, `description` and `quoteType`. The catalogue lists 41 predefined screener ids, from `MOST_ACTIVES` and `equity` to crypto, ETF, mutual-fund, options and private-company lists.

Every row has a title and a description. `quoteType` is null for the one screener that does not name an instrument kind (`analyst_strong_buy_stocks`). Use this route once to discover ids rather than hard-coding them.

## Request

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

## FAQ

### How many predefined screeners are there?

The catalogue lists 41 ids. They cover equities, crypto, ETFs, mutual funds, options and private companies.

### Is quoteType always set?

`quoteType` is the instrument kind the screener runs over (equity, crypto, ETF, mutual fund, option or private company). `analyst_strong_buy_stocks` does not name one, so it is null.

### How do I read one screener?

Pass the id from data.screeners to GET /v1/yahoo-finance/screeners/{screenerId}. Use sort, order and limit to shape the page.

### 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.
