sifting/io
GET/v1/fnd/stocks/screener/:concept/:periodgzip required

Cross-sectional screener

Every filer's reported value for one concept in one period. The screener primitive, answer 'who reported the highest Revenue in Q1 2024?' in a single call.

Auth
X-API-Key header
Format
JSON, gzip-encoded
Rate limits
Per-key, see limits

Example

request · shell
curl -H "X-API-Key: $KEY" -H "Accept-Encoding: gzip" --compressed \
  "https://api.sifting.io/v1/fnd/stocks/screener/Revenues/CY2024Q1?unit=USD&limit=100"
200OKapplication/json (gzip)
{  "taxonomy": "us-gaap",  "concept": "Revenues",  "period": "CY2024Q1",  "unit": "USD",  "label": "Revenues",  "rows": [    {      "cik": "0000320193",      "name": "Apple Inc.",      "value": 90753000000,      "unit": "USD",      "period_end": "2024-03-30",      "accession": "0000320193-24-000089"    }  ],  "meta": { "next_cursor": "eyJvIjo1MH0", "as_of": "2026-05-02T12:34:56Z", "total": 4823 }}
Loading runner…
First load only

Parameters

Parameter
conceptrequiredstring · path
XBRL tag (e.g. Revenues, Assets).
periodrequiredstring · path
SEC calendar period code (see legend below).
taxonomyenum · query
us-gaap (default) | dei | ifrs-full | srt.
unitstring · query
Unit filter. Default USD. Other examples: shares, USD/shares, pure.
limitinteger · query
Page size. Default 50, max 200.
cursorstring · query
Opaque cursor from the previous page.
Accept-Encodingrequiredstring · header
Must include gzip.

Response fields

Field
taxonomystring
XBRL taxonomy of the concept.
conceptstring
XBRL concept tag.
periodstring
SEC calendar period code.
unitstring
Unit filter applied.
labelstring
Human-readable concept label.
rows[]array
One row per filer reporting the concept in the period.
rows[].cikstring
Filer SEC Central Index Key, zero-padded.
rows[].namestring
Company name.
rows[].valuefloat
Reported numeric value.
rows[].unitstring
Unit of the reported value.
rows[].period_endstring (YYYY-MM-DD)
End of the reporting period.
rows[].accessionstring
Source filing accession.
meta.next_cursorstring
Opaque pagination token; pass back as cursor for the next page.
meta.as_ofstring (RFC 3339)
When the response was produced.
meta.totalinteger
Total filers reporting the concept in the period.

More in Financials (XBRL)

See all