Stock Screener API From Intrinio

We looked up the number of google searches for "Stock Screener API" and found out that only between 10-100 people search for it each month. Thats a tiny market, but if that is what you were looking for, you've come to the right place. This article explains what Intrinio's stock screener API is, how to get access, and provides example API calls.

What is the stock screener API?

The stock screener API is just that- it allows a fintech developer to sort through securities to find those that meet a set of predefined conditions. This is not a tool for financial analysts or non-developers. It is really easy to make the API calls but it requires a programming language to do more than copy and paste results.

The screener uses Intrinio's RESTful API to return a list of stocks that meet predefined conditions. The ticker and the value for each parameter are returned and can can be called in just about any language using curl or other packages native to that environment.

How Do I Get Access?

Setting up an Intrinio account and getting API keys is free and easy. You can set up an account and copy your API username and API password at

After you set up an account you will need to visit the data feed marketplace to take a free trial, or subscribe, to the data feeds of your choice. Using the Economic and US Fundamentals and Stock Prices data feeds, you're able to screen stocks based on hundreds of parameters including anything from a balance sheet or income statement and valuation metrics like EBITA and P/E.

This article explains how to get started with the API in general and includes examples of authenticating, sample code in numerous languages (Python, R, Ruby, C#, Node JS, Swift, PHP, etc), and sample API calls.

Example Stock Screener API calls

You can view the documentation for the API screener here. It shows the base syntax of the API and the conditions that can be added to screen stocks. You can look up tags to use in your calls here.

Here is an example showing a single screen for stocks with a price to earnings ratio greater than 15:

The gt represents greater than. If you paste that call into your browser, you should be prompted for your API keys which you can copy from

Stock Screener API example of authentication

Copy and paste your API keys or use the programming language of your choice

Once you have entered your API keys you will see the JSON response:

Results from the stock screener api

JSON response

The end of the response includes the total number of pages so that for screens with more than 250 results a pager can be used to return the entire response.

This example shows how to make an API call with multiple parameters:,pricetoearnings~gte~10

In this case, the response will show stocks with an open price less than or equal to (lte) $10.5 and a P/E ratio greater than or equal to 10 (gte).

This call shows yesterday's price gainers:

And the losers:

This call shows how to find all of the stocks in a specific industry by searching SIC codes:

Its important to note that you can also search text fields, such as the company description, using the "contains" parameter. Don't forget that percents should be in decimal form. For example:

This will return securities with a percent change greater than 200%.

This will return securities with a percent change greater than 2%.,sector~eq~Technology~tech&logic=basicmat OR tech

Above is an example on how to return US securities from both the Technology and Basic Materials sector. Note that there is a space around the OR parameter- if you paste this in your browser it will automatically fill in "%"s that will enable you to use this logic in your code.,security_type~eq~ADR~ADR&logic=(Common%20OR%20ADR)

This will return ADRs or Common stock for securities with those security types.

Why Use Intrinio?

Unlike big data providers, Intrinio doesn't bundle data feeds into an expensive monthly subscription. In fact, many of its feeds offer free trials so that you're able to test out the data before you subscribe.

Unlike smaller data providers, Intrinio only has one API. This means you can subscribe to the data feeds you need while still using a single API or Excel syntax rather than a different syntax for each provider.

This simplicity and cost structure is designed to make financial data easy to access and affordable for fintech developers and financial analysts. Thats our mission and the stock screener API is just another way we are increasing affordable access.