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

---

# Yahoo Finance Screener API

One page from a predefined screener, with totals and a cursor.

`GET /v1/yahoo-finance/screeners/{screenerId}?limit=10` returns `data.screenerId`, `data.canonicalName`, `data.title`, `data.description`, `data.quoteType`, `data.total`, `data.start`, `data.count`, `data.quotes`, `data.page` and `data.windowClamped`. The quote rows are the screener's result records.

Pass a `screenerId` from the screeners catalogue, for example `equity`, `MOST_ACTIVES` or `ALL_CRYPTOCURRENCIES_US`. Page with `limit`, `offset` or the opaque `cursor` from `data.page.nextCursor`, and sort with `sort` and `order` using fields from the screener field catalogue. `windowClamped` is true when the requested offset is past the reachable rows; the page then carries only rows inside your requested window, and the cursor stops instead of repeating rows.

## Request

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

## FAQ

### Where do screener ids come from?

From GET /v1/yahoo-finance/screeners. Pass the id in the path, for example /v1/yahoo-finance/screeners/equity.

### How do I page a screener?

Read data.page.nextCursor and pass it as cursor while data.page.hasMore is true. Stop at data.total. A page past the 10,000-row limit reports windowClamped: true.

### Which sort fields can I use?

A field from the screener field catalogue, such as intradaymarketcap. Send order=asc or order=desc. The default order is desc.

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