apipick Company Facts

Retrieve public company data via stock ticker symbol or SEC CIK number.

Endpoint

GET https://www.apipick.com/api/company/facts

Authentication: x-api-key: YOUR_API_KEY header required. Get a free API key at https://www.apipick.com/dashboard/api-keys

Request Parameters

Use either ticker or cik (not both):

| Parameter | Description | |-----------|-------------| | ticker | Stock ticker symbol (e.g. AAPL, MSFT, GOOGL, TSLA) | | cik | SEC Central Index Key number (e.g. 0000320193) |

# By ticker
GET /api/company/facts?ticker=AAPL

# By CIK
GET /api/company/facts?cik=0000320193

Response

{
  "company_facts": {
    "ticker": "AAPL",
    "name": "Apple Inc.",
    "cik": "0000320193",
    "industry": "Technology",
    "sector": "Consumer Electronics",
    "exchange": "NASDAQ",
    "market_cap": 3000000000000,
    "number_of_employees": 164000,
    "website_url": "https://www.apple.com",
    "sec_filings_url": "https://www.sec.gov/edgar/browse/?CIK=320193"
  }
}

Error Codes

| Code | Meaning | |------|---------| | 400 | Invalid or missing ticker/CIK parameter | | 401 | Missing or invalid API key | | 402 | Insufficient credits |

Cost: 1 credit per request

Usage Pattern

Use $APIPICK_API_KEY env var as the x-api-key header value; if not set, ask the user for their apipick API key
Accept a company name, ticker, or CIK from the user
If the user provides a company name, infer the ticker (e.g. "Apple" → AAPL, "Microsoft" → MSFT)
Make the GET request with ticker or cik
Present results clearly; format market_cap as a readable figure (e.g. $3T, $250B)

See references/api_reference.md for full response field descriptions.