Facts
Knowledge-graph organizations, investments, and acquisitions as structured records.
Facts are stable knowledge-graph entities: companies, investment rounds, and acquisitions. They are not documents. Use them when you need deal amounts, founding dates, or canonical organization IDs.
For the documents that mention those entities, use Proof points. For grouped events that mix documents and facts, use Manifestations.
Each fact type exposes:
- Search — a page of records (
skip/take, max 100) - Time series — counts per bucket; investments and acquisitions also return
amounts
All of these are POST with a JSON body. Date filters use calendar dates (YYYY-MM-DD), not datetimes.
Shared request fields
| Field | Purpose |
|---|---|
topicQuery / gpeQuery / organizationIds | Scope to topics, headquarters region (GPE UUIDs), and organizations |
query | Optional free-text over organization labels (max 50 characters) |
start / end | Inclusive date window |
skip / take | Offset paging; take max 100 |
sortDirection | desc (default) or asc |
resolution | Time series only: month, quarter, or year (default year) |
Field prefixes on topicQuery (title:, summary:, unprefixed/document:) set an IS_ACTIVE_IN score floor of 80 / 60 / 0.
gpeQuery uses the same UUID boolean syntax as topicQuery, but matches the organization’s headquarters: HQ city walks up through IS_LOCATED_IN, so a country term includes companies based in that country. Field prefixes are accepted for syntax parity and do not change HQ matching. Investment and acquisition topicLink selects which party’s HQ is checked. See GPE query syntax.
Entity types
Interactive schemas live in the API reference.