Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sacra.com/llms.txt

Use this file to discover all available pages before exploring further.

Get your API key

Before making requests you need an organization API token. If you don’t have a Sacra account yet, sign up to get started.
  1. Sign in to Sacra and navigate to your organization settings.
  2. Go to API Keys and click Create API Key.
  3. Give the key a name (e.g. my-app) and copy the token — you won’t be able to see it again.
Pass the token in the Authorization header on every request:
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://sacra.com/api/v1/companies/?company_domain=stripe.com"
A successful response confirms your token is valid:
{
  "company": {
    "domain": "stripe.com",
    "name": "Stripe",
    "slug": "stripe"
  }
}

Make your first request

Fetch company data by domain:
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://sacra.com/api/v1/companies/?company_domain=stripe.com"
Get the latest research documents for a company:
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://sacra.com/api/v1/documents/?company_domain=stripe.com"
Use page_after and page_before cursors from the pagination object to page through results.
Search documents and companies by keyword:
curl -X POST \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "fintech revenue"}' \
  https://sacra.com/api/v1/search/

Core concepts

Companies

Look up companies by domain, slug, or ID. Returns financials, milestones, and metadata.

Documents

Browse market research, company one-pagers, and interview transcripts.

Search

Full-text search across all documents and companies.

Events & Metrics

Access company events and financial metrics.

Pagination

Most list endpoints return paginated results. The pagination object in each response tells you how to fetch the next page. Cursor-based (documents, events, metrics, news):
{
  "pagination": {
    "page_size": 30,
    "total_items": 142,
    "next_link": "https://sacra.com/api/v1/documents/?page_after=abc123"
  }
}
Offset-based (search, category items):
{
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 85,
    "next_offset": 20
  }
}
Follow the next_link URL directly — it includes all the query parameters you need.

Next steps

API reference

Explore the full API reference with request and response schemas.

Display company data

Embed company data, charts, and research documents into your site.

Revenue

Understand revenue data types, datapoint periods, and how to interpret financial data.

MCP server

Connect to the Sacra MCP server for AI agent integration.