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.

A document is a piece of original Sacra research — a report, interview, or market analysis produced by Sacra’s analyst team. Documents are the primary way Sacra publishes qualitative insight on private companies, and they’re the source of much of the data that flows into the rest of the platform.

Document types

Sacra produces three types of documents:
TypeDescription
CompanyIn-depth reports on individual companies — covering business model, revenue, growth, competitive position, and Sacra’s analysis.
InterviewTranscripts and edited conversations with founders, executives, and buyers. Buyer interviews in particular capture how customers experience and evaluate a product.
MarketResearch covering a sector, theme, or competitive landscape. Market reports serve as a catch-all for analysis that isn’t scoped to a single company.
The type field on every document is one of company, interview, or market.

Company relationships

A document can be related to a company in one of two ways:
  • subject — the company is the primary focus of the document
  • connected — the company is mentioned or analyzed within a document whose primary subject is something else
When you fetch documents for a specific company, both subject and connected documents are returned, each with a relation field indicating which applies.

Document content

The full document content is available through the detail endpoint. The body is parsed into structured sections, each with a type, title, and elements array. Sections are linked with prev_section and next_section pointers for sequential navigation, and a table_of_contents provides an outline of the full document. Additional metadata includes:
  • reading_time — estimated reading time in minutes
  • has_images — whether the document contains image elements
  • pdf_url — direct link to the PDF on S3
  • web_url — link to the document page on sacra.com

Querying documents

The documents endpoint supports two modes: Company query — pass company_domain or company_id to get all documents related to a specific company. Returns a flat, unpaginated list ordered by relevance. Global query — omit company filters to search across all documents. Requires a created_at or updated_at date range of 14 days or less, and returns paginated results.
Use updated_at_gte for incremental syncs — see Sync Sacra Research & Data for a complete polling guide. Documents can be revised after initial publication, so polling by update time ensures you don’t miss changes to existing reports.