---
title: "Cross-sectional screener (gzip required)"
method: GET
path: "/v1/fnd/stocks/screener/{concept}/{period}"
tags: ["Stocks"]
---

# Cross-sectional screener (gzip required)

`GET /v1/fnd/stocks/screener/{concept}/{period}`

## Request

- Base URL: `https://api.sifting.io`
- URL: `https://api.sifting.io/v1/fnd/stocks/screener/{concept}/{period}`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `api_key`
- TypeScript: <https://skmtc.dev/sifting/apis/siftingio-market-data-api/docs/v1/fnd/stocks/screener/:concept/:period/get.ts> (a function with typed inputs; its response is checked against the schema)

One XBRL concept/period across many companies. Requires `Accept-Encoding: gzip`.

## Path parameters

- `concept` string, required
- `period` string, required

## Query parameters

- `taxonomy` string
- `unit` string
- `cursor` string
- `limit` integer

## Headers

- `Accept-Encoding` 'gzip', required

## Response `200`

Screener rows.

- ScreenerResult
  - `taxonomy` string
  - `concept` string
  - `period` string
  - `unit` string
  - `label` string
  - `rows` ScreenerRow[]
    - `cik` string
    - `name` string
    - `value` number
    - `unit` string
    - `period_end` string, date
    - `accession` string
  - `meta` ListMeta
    - `next_cursor` string: Cursor for the next page; absent on the last page.
    - `as_of` string, date-time
    - `total` integer

## Other responses

- `400`: Invalid request parameters.
- `401`: Missing or invalid API key.
- `406`: This endpoint requires `Accept-Encoding: gzip`.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/sifting/apis/siftingio-market-data-api.md) - [All operations](https://skmtc.dev/sifting/apis/siftingio-market-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sifting/apis/siftingio-market-data-api/revisions/c570068c2359?raw)