# SEC EDGAR Corporate Filing Intelligence API

Search SEC-registered public companies, browse their filings, and extract key financial
metrics (Revenue, Net Income, EPS, Assets) from XBRL data. Government public data with
an intelligence layer: YoY growth rates, human-readable amounts, normalized structures.

## API Base URL

https://edgar.hugen.tokyo

## Endpoints

- GET /edgar/company?q=Apple — Search companies by name or ticker ($0.01)
- GET /edgar/filings?cik=320193&type=10-K — Recent filings for a company ($0.01)
- GET /edgar/facts?cik=320193 — Key financial facts with growth rates ($0.01)

## Parameters

### /edgar/company
- q (required): Company name or ticker symbol to search
- limit (optional): Max results, 1-20 (default: 10)

### /edgar/filings
- cik (required): SEC CIK number (with or without leading zeros)
- type (optional): Filter by form type — 10-K, 10-Q, 8-K, etc (default: all)
- limit (optional): Max results, 1-50 (default: 20)

### /edgar/facts
- cik (required): SEC CIK number (with or without leading zeros)

## Response Format

All responses include structured JSON with human-readable display values.
Financial amounts are formatted (e.g. "$416.2B") alongside raw numeric values.
Growth rates are calculated year-over-year from annual (10-K) filings.

## Use Cases

- Company lookup: "What is Apple's CIK number?"
- Filing research: "Show me Tesla's recent 10-K filings"
- Fundamental analysis: "What is Microsoft's revenue trend and YoY growth?"
- Due diligence: "Get the latest financial facts for CIK 320193"