FMP Stock Screener Pagination Makes Large-Scale Equity Research Easier

FMP added pagination to the Stock Screener endpoint, making it easier for users to move through larger result sets and build broader equity screens.

The update allows investors, analysts, and developers to request results by page instead of relying on a single response. That matters when a screen returns more companies than one request can comfortably support, especially for broader market maps, sector screens, peer lists, and recurring research workflows.

The Stock Screener API still serves the same core purpose: helping users narrow a broad market universe into a focused list of companies that match specific criteria. Users can filter by variables such as market capitalization, price, volume, beta, sector, country, and other financial characteristics.

With pagination, that first research layer becomes easier to manage at scale. A user can start with a broad screen, collect results in batches, and then apply deeper analysis using company profiles, financial statements, valuation ratios, analyst estimates, historical prices, or other FMP datasets.

Key Takeaways

  • FMP added pagination to the Stock Screener endpoint, allowing users to move through extended search results instead of relying on a single response.
  • The updated endpoint is more useful for broad screens, market mapping, and systematic research workflows.
  • Pagination helps analysts separate discovery from deeper analysis by first collecting a larger qualified universe.
  • Investors can use page-based screening to build cleaner watchlists, peer sets, sector screens, and recurring research pipelines.

Why The Stock Screener Matters

A screener is most useful when the research question is specific.

  • An investor may want U.S. technology companies above a certain market capitalization.
  • An analyst may want liquid stocks in one sector with a defined price range.
  • A portfolio team may want to review companies by country, industry, beta, or trading volume before applying deeper valuation or fundamentals work.

The screener does not replace analysis. It creates the first research layer.

Good equity research often starts with a broad universe, then narrows through multiple stages: business quality, liquidity, valuation, profitability, growth, risk, and portfolio fit. The Stock Screener API supports that first step by returning companies that match the user's selected filters.

What Changed In The Updated Endpoint

FMP's changelog notes that pagination was added to the Stock Screener endpoint, allowing users to loop through extended search results.

The practical change is simple but important: users can now request results by page.

The updated stable endpoint is:

https://financialmodelingprep.com/stable/company-screener?apikey=YOUR_API_KEY

The updated version keeps the core screening logic but adds a more scalable way to move through larger result sets.

Old Version Vs Updated Version

Area

Legacy Screener

Updated Screener

Endpoint style

Legacy API route

Stable API route

Example endpoint

/api/v3/stock-screener

/stable/company-screener

Result handling

More limited for extended result sets

Supports page-based result collection

Research fit

Useful for smaller or narrower screens

Better for broad screens and repeatable workflows

Workflow impact

One request may not capture the full opportunity set

Users can loop through pages and build a larger universe

The core benefit is not only more results. It is better research control.

When a screen returns many companies, pagination lets the user decide how much of the universe to collect, where to stop, and how to process the data in batches.

How Investors And Analysts Can Use Pagination

Pagination is especially useful when the first screen is intentionally broad.

For example, an analyst studying U.S. technology stocks may not want only the first group of results. They may want every company that fits the initial criteria, then apply a second layer of analysis using ratios, income statements, analyst estimates, or market data.

A portfolio analyst could use pagination to:

  • Build a complete sector watchlist.
  • Compare companies across market-cap ranges.
  • Identify liquid stocks before running valuation work.
  • Create recurring screens that update weekly or monthly.
  • Feed a larger universe into a dashboard, model, or notebook.

This makes the screener more useful for systematic research. Instead of treating the API call as a one-time lookup, users can turn it into the first step of a repeatable equity workflow.

Example: Screening Large Technology Companies

A user looking for large technology companies could start with a request like this:

https://financialmodelingprep.com/stable/company-screener?sector=Technology&marketCapMoreThan=10000000000&limit=100&page=0&apikey=YOUR_API_KEY

Then the user can request the next page:

https://financialmodelingprep.com/stable/company-screener?sector=Technology&marketCapMoreThan=10000000000&limit=100&page=1&apikey=YOUR_API_KEY

A simple workflow may look like this:

import requests


API_KEY = "YOUR_API_KEY"

base_url = "https://financialmodelingprep.com/stable/company-screener"


all_results = []


for page in range(0, 5):

params = {

"sector": "Technology",

"marketCapMoreThan": 10_000_000_000,

"limit": 100,

"page": page,

"apikey": API_KEY

}


response = requests.get(base_url, params=params)

data = response.json()


if not data:

break


all_results.extend(data)


print(f"Collected {len(all_results)} companies")

From there, the investor can take the collected symbols and run deeper work. That may include reviewing company profiles, financial statements, valuation ratios, analyst estimates, historical prices, or news.

The pagination step helps ensure the initial universe is not cut short too early.

Why This Matters For Research Quality

Small screens are easy to manage manually. Large screens require structure.

Pagination helps users avoid an incomplete starting point. If the research process begins with only a partial list, the next steps can also become incomplete. That can affect peer comparisons, opportunity screens, dashboard outputs, and portfolio research.

The updated Stock Screener endpoint gives investors and analysts a cleaner way to collect the full set of companies that match their criteria.

The result is a better first layer of analysis: broader when needed, more repeatable, and easier to connect to the rest of the research process.

FAQ

What Is The FMP Stock Screener API?

The FMP Stock Screener API allows users to filter companies based on criteria such as market capitalization, price, volume, beta, sector, country.

What Was Added To The Stock Screener Endpoint?

FMP added pagination, which allows users to request results by page and loop through extended search results.

Why Is Pagination Useful For Stock Screening?

Pagination is useful when a screen returns more results than a single request can comfortably handle. It lets users collect larger result sets in a structured way.

How Can Analysts Use The New Page Parameter?

Analysts can use the page parameter to move through multiple batches of results, build a complete stock universe, and then apply deeper financial or valuation analysis.

Does Pagination Change The Screening Criteria?

No. Pagination changes how results are retrieved. Users can still apply filters such as sector, market cap, price, volume, beta, and country.

What Is A Practical Use Case For Pagination?

A practical use case is building a full watchlist of U.S. technology companies above a certain market capitalization, then using the collected symbols for deeper analysis across fundamentals, valuation, and market performance.

About the Author
Sanzhi Kobzhan

Treasury, trading, liquidity, and equity analysis for investors

Sanzhi writes for FMP with a focus on equity analysis, valuation, market data, and practical investment decision-making. He has worked across financial institutions in treasury, trading, and liquidity roles, bringing hands-on experience in investment analysis, market execution, risk, and strategy. His work focuses on helping readers interpret financial data with clarity, discipline, and an institutional market perspective.

Related

Financial data for every need

Real-time quotes and 30+ years of historical data, including prices, fundamentals, and insider transactions — all accessible via API.

Create Free Account