Plan: Fund · Credits: 1 per call; screen facets and terms are free
What You Can Use Company Screening For
Detailed Company Filter Pages
By fundamentals
Size, valuation, margins, growth, momentum.
By guidance
Better/worse vs raises/cuts, with dates.
By events
Five sources, one cross-market rollup.
By products & peers
The entity-relations graph.
By positioning
Short interest, insiders, CEO pay, Taiwan.
Start With Company Screen Facets
Setlist_facets to true to get the filterable vocabulary with counts, free of charge. Filter values are exact, and a misspelled value returns an empty page rather than an error, so the facets response is how you confirm a value exists before concluding that no companies match it.
The Ten Company Screening Axes
Identity —country, sector, industry, exchange, has_cik.
Size — market_cap_usd_gte and market_cap_usd_lte, converted to US dollars so sizes are comparable across countries.
Momentum — ret_1m, ret_3m, ret_6m and ret_12m bounds, expressed as percentages, plus include_suspect_returns.
Valuation — pe_ttm, pb, ps_ttm, fcf_yield, dividend_yield.
Profitability and leverage — gross_margin, operating_margin, net_margin, return_on_equity, debt_to_equity, revenue_growth_yoy, eps_growth_yoy, is_lossmaking.
Guidance — guidance_better_90d_gte, guidance_worse_90d_gte, guidance_raises_90d_gte, guidance_cuts_90d_gte, and the date forms guidance_better_since and guidance_worse_since.
Events over 90 days — event_family, event_source, news_event_type, and rollup_family, the one that spans markets. Each has a date form: event_family_since, news_event_type_since, rollup_family_since.
Positioning — short_percent_float, days_to_cover, insider_net_90d, insider_ownership_pct, ceo_total_comp.
Taiwan — tw_foreign_held_pct, tw_revenue_yoy_pct.
Products and relationships — makes_term, related_to_term, peer_of, competitor_of.
How to Phrase Common Company Screens
“Which companies raised guidance this quarter” isguidance_better_90d_gte=1, or guidance_better_since with a date.
“Who filed for bankruptcy” is event_family=bankruptcy.
“Japanese companies that revised their forecast this month” is event_family=earnings_forecast_revision with event_family_since.
“The most shorted mid caps” is a market-cap band sorted by short_percent_float.
“Cheap profitable tech” is pe_ttm_lte with a sector and a margin floor.
Always Look Up Product Terms First
The product vocabulary holds 60,620 terms, and it expands spellings, not concepts.memory, dram, nand and memory chips are four separate terms with four separate company lists, so makes_term=memory on its own misses Kioxia, Winbond and Nanya.
Use find_terms to list the spellings first, then pass every spelling it shows you.
Coverage on this axis is 3,130 companies carrying a product term out of 25,206, and 4,403 companies reachable by peer_of or competitor_of. An empty result means FocusAlpha holds nothing for that company on that axis — never that the company makes nothing or has no peers — and it is worth saying which.
Every Match Carries Its Evidence
Product and relationship matches come back withmatched_terms or matched_relation: the term that matched, its sources, its grade, and whether a peer selection was mutual.
The evidence travels with the row because a product list nobody can check is a product list nobody should trust.
Company Screening Date Convention
The event and guidance axes look back 90 days by default. The_since forms replace that window with an explicit start date, which is how you screen a quarter, a month, or the period since a specific event rather than a rolling 90 days.
Company Screening Sources
Identity comes from the company registry. Size, momentum and valuation come from market data and financial statements. Guidance comes from management guidance. Events come from 8-K events, the news event layer and the Asian exchange disclosure feeds. Positioning comes from short interest, insider trades and proxy ownership. Products and relationships come from FocusAlpha’s entity-relations graph, built from filings.Query the Company Screen
Use the screen endpoint. Filters are combined with AND. No filter is required.boolean
Return the filterable vocabulary with counts instead of results. Free.
string
Country of the company.
sector, industry and exchange narrow the same way.number
Market-cap floor in USD.
market_cap_usd_lte sets the ceiling.number
Minimum count of guidance metrics that improved in the last 90 days.
guidance_worse_90d_gte, guidance_raises_90d_gte and guidance_cuts_90d_gte work the same way.string
An event family observed in the last 90 days.
event_family_since replaces the window with an explicit start date.string
An event family normalised across markets, so one question spans SEC, Asian exchange and news sources.
string
A product term the company is linked to. Call
find_terms first and pass every spelling.string
Companies named as peers of this one.
competitor_of finds companies that name it as a competitor.string
Any filterable measure, so the axis you screened on is also the axis you can rank on.
order is asc or desc.integer
Rows per page. Page through with
cursor.has_fundamentals, fundamentals_stale and include_suspect_returns.