Getting Started

Get up and running with the Beefi.ai API in under 5 minutes.

1. Get your API key

Sign up at beefi.ai and create an API key from your dashboard. Your key starts with bf_.

2. Make your first request

Search for a company by name or ticker:

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.beefi.ai/api/v1/companies/search?q=tesla"

3. Explore endpoints

Once you have a company's CIK or ticker, you can fetch:

• • Stock prices — historical and latest OHLCV data
• • Financial statements — income, balance sheet, cash flow
• • Company metrics — XBRL-extracted financial facts
• • Insider trades — Form 3/4/5 transactions
• • SEC filings — 10-K, 10-Q, 8-K, and more

Response format

All responses are JSON. Successful responses return data directly. Errors return:

{
  "detail": "Error message describing what went wrong"
}