---
title: "Facet the SEC companies dataset"
method: GET
path: "/datasets/sec-companies/facets"
tags: ["Datasets"]
---

# Facet the SEC companies dataset

`GET /datasets/sec-companies/facets`

## Request

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

Returns terms-aggregation counts for one facet of the SEC companies dataset, scoped to the same filters as search. Facet enum: `sic`, `sic_description`, `exchange`, `state_of_incorporation`, `entity_type`, `reporting_currency`, `revenue_band`, `forms_filed`. `revenue_band` buckets latest-annual revenue into: `unknown`, `under_1m`, `1m_10m`, `10m_100m`, `100m_1b`, `1b_10b`, `over_10b`.

## Query parameters

- `facet` 'sic' | 'sic_description' | 'exchange' | 'state_of_incorporation' | 'entity_type' | 'reporting_currency' | 'revenue_band' | 'forms_filed', required
- `q` string
- `ticker` string
- `sic` string
- `exchange` string
- `state_of_incorporation` string
- `entity_type` string
- `reporting_currency` string
- `has_financials` boolean
- `min_revenue` number
- `form_filed` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsSecCompaniesFacetResponseDoc
  - `code` integer
  - `data` DatasetsSecCompanyFacetResponse
    - `dataset` string
    - `facet` string
    - `items` EsSecCompanyFacetItem[]
      - `count` integer
      - `value` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error

---

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