Skip to main content
POST
/
api
/
finviz
/
screener
/finviz/screener
curl --request POST \
  --url https://api.anysite.io/api/finviz/screener \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300
}
'
[
  {
    "id": "<string>",
    "@type": "@finviz_screener_stock",
    "name": "<string>",
    "sector": "<string>",
    "industry": "<string>",
    "country": "<string>",
    "exchange": "<string>",
    "index": "<string>",
    "price": 123,
    "prev_close": 123,
    "open": 123,
    "high": 123,
    "low": 123,
    "change_percent": 123,
    "target_price": 123,
    "market_cap": 123,
    "enterprise_value": 123,
    "income": 123,
    "sales": 123,
    "pe": 123,
    "forward_pe": 123,
    "peg": 123,
    "ps": 123,
    "pb": 123,
    "pc": 123,
    "pfcf": 123,
    "ev_ebitda": 123,
    "ev_sales": 123,
    "book_per_share": 123,
    "cash_per_share": 123,
    "dividend_ttm": 123,
    "dividend_est": 123,
    "dividend_est_yield_percent": 123,
    "dividend_ex_date": "<string>",
    "dividend_growth_1y_percent": 123,
    "dividend_growth_3y_percent": 123,
    "dividend_growth_5y_percent": 123,
    "payout_percent": 123,
    "eps_ttm": 123,
    "eps_next_q": 123,
    "eps_this_y_percent": 123,
    "eps_next_y_percent": 123,
    "eps_past_3y_percent": 123,
    "eps_past_5y_percent": 123,
    "eps_next_5y_percent": 123,
    "eps_qoq_percent": 123,
    "eps_yoy_ttm_percent": 123,
    "eps_surprise_percent": 123,
    "sales_past_3y_percent": 123,
    "sales_past_5y_percent": 123,
    "sales_qoq_percent": 123,
    "sales_yoy_ttm_percent": 123,
    "sales_surprise_percent": 123,
    "shares_outstanding": 123,
    "shares_float": 123,
    "float_percent": 123,
    "insider_own_percent": 123,
    "insider_trans_percent": 123,
    "inst_own_percent": 123,
    "inst_trans_percent": 123,
    "short_float_percent": 123,
    "short_ratio": 123,
    "short_interest": 123,
    "roa_percent": 123,
    "roe_percent": 123,
    "roic_percent": 123,
    "current_ratio": 123,
    "quick_ratio": 123,
    "debt_eq": 123,
    "lt_debt_eq": 123,
    "gross_margin_percent": 123,
    "operating_margin_percent": 123,
    "profit_margin_percent": 123,
    "perf_week_percent": 123,
    "perf_month_percent": 123,
    "perf_quarter_percent": 123,
    "perf_half_year_percent": 123,
    "perf_year_percent": 123,
    "perf_ytd_percent": 123,
    "perf_3y_percent": 123,
    "perf_5y_percent": 123,
    "perf_10y_percent": 123,
    "beta": 123,
    "atr": 123,
    "rsi": 123,
    "volatility_week_percent": 123,
    "volatility_month_percent": 123,
    "sma20_percent": 123,
    "sma50_percent": 123,
    "sma200_percent": 123,
    "high_50d_percent": 123,
    "low_50d_percent": 123,
    "high_52w_percent": 123,
    "low_52w_percent": 123,
    "all_time_high_percent": 123,
    "all_time_low_percent": 123,
    "change_from_open_percent": 123,
    "gap_percent": 123,
    "recommendation": 123,
    "avg_volume": 123,
    "rel_volume": 123,
    "volume": 123,
    "employee_count": 123,
    "earnings": "<string>",
    "ipo_date": "<string>",
    "asset_type": "<string>",
    "holdings_count": 123,
    "aum": 123,
    "expense_percent": 123,
    "flows_1m": 123,
    "flows_1m_percent": 123,
    "flows_3m": 123,
    "flows_3m_percent": 123,
    "flows_ytd": 123,
    "flows_ytd_percent": 123,
    "return_1y_percent": 123,
    "return_3y_percent": 123,
    "return_5y_percent": 123
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required

Maximum number of stocks to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
exchange
enum<string> | null

Filter by listing exchange

Available options:
amex,
cboe,
nasd,
nyse
index
enum<string> | null

Filter by membership in a major index

Available options:
sp500,
ndx,
dji,
rut
sector
enum<string> | null

Filter by sector

Available options:
basicmaterials,
communicationservices,
consumercyclical,
consumerdefensive,
energy,
financial,
healthcare,
industrials,
realestate,
technology,
utilities
market_cap
enum<string> | null

Filter by market capitalization tier

Available options:
mega,
large,
mid,
small,
micro,
nano
recommendation
enum<string> | null

Filter by analyst recommendation

Available options:
strong_buy,
buy,
hold,
sell,
strong_sell
dividend_yield
enum<string> | null

Filter by dividend yield

Available options:
none,
positive,
high,
very_high,
over_1,
over_2,
over_3,
over_5
price
enum<string> | null

Filter by share price range

Available options:
under_5,
under_10,
under_20,
under_50,
over_5,
over_10,
over_20,
over_50

Response

Successful Response

id
string
required
@type
string
default:@finviz_screener_stock
name
string | null
sector
string | null
industry
string | null
country
string | null
exchange
string | null
index
string | null
price
number | null
prev_close
number | null
open
number | null
high
number | null
low
number | null
change_percent
number | null
target_price
number | null
market_cap
number | null
enterprise_value
number | null
income
number | null
sales
number | null
pe
number | null
forward_pe
number | null
peg
number | null
ps
number | null
pb
number | null
pc
number | null
pfcf
number | null
ev_ebitda
number | null
ev_sales
number | null
book_per_share
number | null
cash_per_share
number | null
dividend_ttm
number | null
dividend_est
number | null
dividend_est_yield_percent
number | null
dividend_ex_date
string | null
dividend_growth_1y_percent
number | null
dividend_growth_3y_percent
number | null
dividend_growth_5y_percent
number | null
payout_percent
number | null
eps_ttm
number | null
eps_next_q
number | null
eps_this_y_percent
number | null
eps_next_y_percent
number | null
eps_past_3y_percent
number | null
eps_past_5y_percent
number | null
eps_next_5y_percent
number | null
eps_qoq_percent
number | null
eps_yoy_ttm_percent
number | null
eps_surprise_percent
number | null
sales_past_3y_percent
number | null
sales_past_5y_percent
number | null
sales_qoq_percent
number | null
sales_yoy_ttm_percent
number | null
sales_surprise_percent
number | null
shares_outstanding
number | null
shares_float
number | null
float_percent
number | null
insider_own_percent
number | null
insider_trans_percent
number | null
inst_own_percent
number | null
inst_trans_percent
number | null
short_float_percent
number | null
short_ratio
number | null
short_interest
number | null
roa_percent
number | null
roe_percent
number | null
roic_percent
number | null
current_ratio
number | null
quick_ratio
number | null
debt_eq
number | null
lt_debt_eq
number | null
gross_margin_percent
number | null
operating_margin_percent
number | null
profit_margin_percent
number | null
perf_week_percent
number | null
perf_month_percent
number | null
perf_quarter_percent
number | null
perf_half_year_percent
number | null
perf_year_percent
number | null
perf_ytd_percent
number | null
perf_3y_percent
number | null
perf_5y_percent
number | null
perf_10y_percent
number | null
beta
number | null
atr
number | null
rsi
number | null
volatility_week_percent
number | null
volatility_month_percent
number | null
sma20_percent
number | null
sma50_percent
number | null
sma200_percent
number | null
high_50d_percent
number | null
low_50d_percent
number | null
high_52w_percent
number | null
low_52w_percent
number | null
all_time_high_percent
number | null
all_time_low_percent
number | null
change_from_open_percent
number | null
gap_percent
number | null
recommendation
number | null
avg_volume
number | null
rel_volume
number | null
volume
integer | null
employee_count
integer | null
earnings
string | null
ipo_date
string | null
asset_type
string | null
holdings_count
integer | null
aum
number | null
expense_percent
number | null
flows_1m
number | null
flows_1m_percent
number | null
flows_3m
number | null
flows_3m_percent
number | null
flows_ytd
number | null
flows_ytd_percent
number | null
return_1y_percent
number | null
return_3y_percent
number | null
return_5y_percent
number | null