Social Fetch
Start for freeStart free
Yahoo Finance hub

Yahoo Finance Screener API

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

GET /v1/yahoo-finance/screeners/{screenerId}

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

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.

Yahoo Finance Screener API 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.

Other Yahoo Finance endpoints