Endpoint Playground
Test Crawlora's SEC Company Financials Dataset API with realistic prefilled filters. Generate a cURL request, inspect stored structured JSON records, and open the full docs or pricing page when you are ready to integrate dataset search. Dataset Playground requests query indexed data and do not apply proxy routing.
curl "https://api.crawlora.net/api/v1/datasets/sec-companies/financials/<cik>?statement=income&period=annual" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| cik (path) | string | Yes | SEC CIK, numeric or zero-padded | |
| statement | string | No | income | Statement enum: income, balance, cash_flow. Omit to return all three. |
| period | string | No | annual | Period-type enum: annual, quarterly. Omit to return both. |
| from | integer | No | Inclusive lower bound on fiscal_year | |
| to | integer | No | Inclusive upper bound on fiscal_year | |
| limit | integer | No | Maximum points returned (most recent fiscal years first), default 100, max 400 |
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "sec-companies",
"cik": 320193,
"count": 2,
"points": [
{
"cik": 320193,
"statement": "income",
"period": "annual",
"fiscal_year": 2024,
"fiscal_period": "FY",
"end_date": "2024-09-28",
"form": "10-K",
"currency": "USD",
"lines": {
"revenue": 391035000000,
"net_income": 93736000000,
"gross_profit": 180683000000
},
"ratios": {
"gross_margin": 0.4621,
"net_margin": 0.2397,
"revenue_growth_yoy": 0.0206
}
},
{
"cik": 320193,
"statement": "income",
"period": "annual",
"fiscal_year": 2023,
"fiscal_period": "FY",
"end_date": "2023-09-30",
"form": "10-K",
"currency": "USD",
"lines": {
"revenue": 383285000000,
"net_income": 96995000000
}
}
]
}
}Public Playground
Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.
Returns a company's normalized financial-statement history (income statement, balance sheet, cash flow) from the SEC companies dataset, newest fiscal year first. An unknown CIK or a company with no XBRL data returns an empty series rather than a 404 — most filers without a current ticker have no financial-statement history at all. `lines` keys are the same normalized concept names the live `/sec/financials` endpoint uses (e.g. `revenue`, `net_income`, `total_assets`); `ratios` keys include `gross_margin`, `operating_margin`, `net_margin`, `revenue_growth_yoy`, `current_ratio`, `debt_to_equity`, `free_cash_flow` where derivable. statement enum: `income`, `balance`, `cash_flow`. period enum: `annual`, `quarterly`. Dataset endpoints are built for repeatable structured search, facets, geo queries, pagination, and item lookup over indexed records. They do not trigger live scraping or proxy routing.
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "sec-companies",
"cik": 320193,
"count": 2,
"points": [
{
"cik": 320193,
"statement": "income",
"period": "annual",
"fiscal_year": 2024,
"fiscal_period": "FY",
"end_date": "2024-09-28",
"form": "10-K",
"currency": "USD",
"lines": {
"revenue": 391035000000,
"net_income": 93736000000,
"gross_profit": 180683000000
},
"ratios": {
"gross_margin": 0.4621,
"net_margin": 0.2397,
"revenue_growth_yoy": 0.0206
}
},
{
"cik": 320193,
"statement": "income",
"period": "annual",
"fiscal_year": 2023,
"fiscal_period": "FY",
"end_date": "2023-09-30",
"form": "10-K",
"currency": "USD",
"lines": {
"revenue": 383285000000,
"net_income": 96995000000
}
}
]
}
}curl "https://api.crawlora.net/api/v1/datasets/sec-companies/financials/<cik>" \
-H "x-api-key: $CRAWLORA_API_KEY"