API Reference

Query financial metrics for any public or private company. All responses include a source URL and confidence score.

Get free API key Browse companies

Base URL

https://api.companyfinancials.io/v1

Authentication

All requests require an API key in the X-Api-Key header. Get a free key →

Endpoints

POST/company/lookup

Retrieve revenue, employee count, and custom financial metrics for a company. Returns per-metric confidence scores and source evidence.

Parameter	Type	Description
companyName	string	Required. Company name, e.g. "Apple Inc."
year	string	Optional. Fiscal year, e.g. "2024". Defaults to last completed year.
country	string	Optional. ISO country code, e.g. "US". Improves accuracy for companies with common names.
metrics	string[]	Optional. Metrics to return. Defaults to ["revenue", "employeeCount"]. Custom metrics (EBITDA, gross margin, etc.) require Pro or higher.
depth	"quick" \| "deep" \| "auto"	Optional. "quick" (default) uses web search. "deep" reads annual report PDFs directly for higher accuracy. "auto" starts quick and upgrades to deep if confidence is below autoDeepThreshold. Deep search requires Pro or higher.
autoDeepThreshold	number 1–10	Optional. Only used when depth is "auto". If quick search confidence is below this value, a deep search is run automatically. Defaults to 8.
reportUrl	string	Optional. Provide a direct PDF URL to extract metrics from that specific document.

Request

curl

curl -X POST https://api.companyfinancials.io/v1/company/lookup \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{
    "companyName": "Apple Inc.",
    "year": "2024"
  }'

Response

json

{
  "companyName": "Apple Inc.",
  "revenue": 391035000000,
  "currency": "USD",
  "year": "2024",
  "employeeCount": 161000,
  "source": "Apple 10-K 2024",
  "sourceUrl": "https://investor.apple.com/sec-filings/annual-reports/...",
  "confidence": 9,
  "metrics": {
    "revenue": {
      "value": 391035000000,
      "unit": "USD",
      "confidence": 9,
      "source": "Apple 10-K 2024",
      "sourceUrl": "https://investor.apple.com/sec-filings/annual-reports/...",
      "evidence": {
        "pageNumber": 31,
        "excerpt": "Net sales: $391,035 million",
        "section": "Consolidated Statements of Operations"
      }
    },
    "employeeCount": {
      "value": 161000,
      "unit": "headcount",
      "confidence": 9,
      "source": "Apple 10-K 2024",
      "sourceUrl": "https://investor.apple.com/sec-filings/annual-reports/...",
      "evidence": {
        "pageNumber": 1,
        "excerpt": "As of September 28, 2024, Apple had approximately 161,000 full-time employees.",
        "section": "Business Overview"
      }
    }
  }
}

POST/company/lookupPro+

Use the depth parameter to control extraction quality. deep reads annual report PDFs directly for audited figures with page-level evidence. auto starts with a quick search and upgrades to deep automatically when confidence is below autoDeepThreshold.

Request

curl

# Force deep search (reads annual report PDFs directly)
curl -X POST https://api.companyfinancials.io/v1/company/lookup \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{
    "companyName": "Stripe",
    "year": "2023",
    "depth": "deep"
  }'

# Auto mode: quick first, upgrades to deep if confidence < threshold
curl -X POST https://api.companyfinancials.io/v1/company/lookup \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{
    "companyName": "Stripe",
    "year": "2023",
    "depth": "auto",
    "autoDeepThreshold": 7
  }'

Confidence scores

Every metric includes a confidence score from 1–10.

9–10	Extracted directly from audited financial statements
7–8	Sourced from official company communications
5–6	From secondary sources, verify before use
1–4	Estimated or inferred, manual review recommended

Rate limits

Plan	Monthly credits	Per-minute	Deep search
Free	10	10/min	—
Starter	100	100/min	—
Pro	400	100/min	✓
Business	2,500	100/min	✓
Enterprise	9,500	Custom	✓

Ready to start querying financial data?

Get a free API key, 10 credits/month