SEC Company Financials Dataset API

Endpoint facts

Method

GET

API path

/datasets/sec-companies/financials/{cik}

Auth

apiKey

Credits

1 credit/request

Platform

Datasets

Response schema

#/definitions/datasets.secCompaniesFinancialsResponseDoc

Overview

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`. Developers commonly use this endpoint for repeatable dataset search, filtering, facets, local business enrichment, analytics, exports, and internal tools that need structured records beyond the limited manual refinement available in the Google Maps app. Authentication uses the x-api-key header, usage is metered with the credit cost shown on this page, and the request does not trigger live scraping or proxy routing.

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost

1 credit/request

Charged response

Successful 2xx responses

Infrastructure behavior

This endpoint reads stored indexed dataset records. It does not execute a live upstream Google Maps request, browser session, or proxy-routed scraping job.

• Data source: stored Crawlora dataset records
• Proxy strategy: no proxy routing is applied
• Browser rendering: not used for dataset search or lookup requests
• Live scraping: not triggered by dataset list, search, nearby, facet, or detail endpoints
• Validation: invalid filters, coordinates, pagination, and enum values return documented errors
• Billing: credits are charged only for successful 2xx responses
• Observability: responses include request context where available

Response behavior

- An unknown CIK or a company with no XBRL data returns an empty series (HTTP `200` with `count: 0`) 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 `GET /sec/financials` endpoint uses (e.g. `revenue`, `net_income`, `total_assets`, `operating_cash_flow`). - `ratios` keys include `gross_margin`, `operating_margin`, `net_margin`, `revenue_growth_yoy`, `current_ratio`, `debt_to_equity`, `free_cash_flow` where derivable from the reported lines. - A period's `_id` is keyed by `(cik, statement, period, fiscal_year[, fiscal_period])`, so a later crawl that picks up an SEC restatement overwrites that period's figures rather than duplicating it — there is only ever one point per fiscal period. Example response: ```json { "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 } } ] } } ```

Error behavior

Crawlora does not silently return invalid dataset search results when filters, pagination, coordinates, or stored record lookups cannot be satisfied.

When possible, Crawlora returns structured error context so your integration can adjust filters, page size, location inputs, or lookup identifiers.

Related