---
title: "Screen companies"
method: GET
path: "/screener"
tags: ["Screener"]
---

# Screen companies

`GET /screener`

## Request

- Base URL: `https://api.signal8.ai/api/v1/public`
- URL: `https://api.signal8.ai/api/v1/public/screener`
- Auth: API key in header `X-Api-Key`

Screen the company universe with sector/industry, price, volume, float,
shares-outstanding, market-cap, and cash-runway filters. Supports
numeric-range and text filters with sorting and pagination.

**Credit cost: 25**

## Query parameters

- `industry` string
- `minPrice` number
- `maxPrice` number
- `minVolume` integer
- `maxVolume` integer
- `minCashRunway` number
- `maxCashRunway` number
- `minFloat` integer
- `maxFloat` integer
- `minSharesOutstanding` integer
- `maxSharesOutstanding` integer
- `minMarketCapComputed` integer
- `maxMarketCapComputed` integer
- `sortBy` string
- `sortOrder` string
- `excludeHalted` boolean
- `limit` integer
- `offset` integer

## Response `200`

Screener results with pagination

- object

## Other responses

- `400`: Invalid request parameters
- `401`: Missing or invalid API key
- `402`: Not enough credits for this request
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/signal8/apis/signal8-public-api.md) · [All operations](https://skmtc.dev/signal8/apis/signal8-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signal8/apis/signal8-public-api/revisions/5a18ae8d6d58?raw)