Datasets

Search the SEC companies dataset

Searches SEC-reporting companies — filing history, financial-statement rollups (latest annual/quarterly revenue, net income, total assets) and trailing-90-day insider (Form 3/4/5) activity. Sort enum: relevance, name_asc, revenue_desc, net_income_desc, filing_recent_desc, insider_activity_desc. entity_type, sic, sic_description, exchange, and state_of_incorporation are open filters over the exact values EDGAR reports for each filer (not a fixed enum) — discover real values via the matching facet. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).

get/datasets/sec-companies/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/datasets/sec-companies/search
  • Auth: API key in header x-api-key

Query parameters

qstring

Full-text query over the company name, or an exact ticker match, max 256 characters

tickerstring

Exact ticker filter (case-insensitive), e.g. AAPL, max 32 characters

cikstring

Exact CIK filter, numeric or zero-padded, e.g. 320193 or 0000320193

sicstring

Exact SIC industry-code filter, e.g. 3571, max 32 characters

sic_descriptionstring

Exact SIC description filter, e.g. Electronic Computers, max 128 characters

exchangestring

Exact exchange filter as reported by EDGAR, e.g. Nasdaq, NYSE, max 64 characters

state_of_incorporationstring

Exact state/country-of-incorporation filter as reported by EDGAR, e.g. DE, CA, max 32 characters

entity_typestring

Exact entity-type filter as reported by EDGAR (e.g. operating), max 64 characters

reporting_currencystring

Exact reporting-currency filter, ISO-4217 code, e.g. USD, JPY, EUR

has_financialsboolean

When true, keep only companies that have XBRL financial statements

min_revenuenumber

Minimum latest-annual revenue in USD (normalized from the filer's reporting currency at reference rates), 0 or greater

max_revenuenumber

Maximum latest-annual revenue in USD (normalized), 0 or greater

min_net_incomenumber

Minimum latest-annual net income in USD (normalized; negative allowed)

min_total_assetsnumber

Minimum latest-annual total assets in USD (normalized), 0 or greater

form_filedstring

Exact form-type filter; keeps only companies that have ever filed this form, e.g. 10-K, 8-K

min_insider_txn_count_90dinteger

Minimum insider (Form 3/4/5) transaction count in the trailing 90 days, 0 or greater

sort'relevance' | 'name_asc' | 'revenue_desc' | 'net_income_desc' | 'filing_recent_desc' | 'insider_activity_desc'

Sort enum: relevance, name_asc, revenue_desc, net_income_desc, filing_recent_desc, insider_activity_desc

pageinteger

Page number, defaults to 1

page_sizeinteger

Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.