Organizations

Organization facts are canonical company and institution records from the knowledge graph. See also how organizations are modeled.

Endpoints:

POST /facts/organizations/search — playground
POST /facts/organizations/time-series — playground

Time series buckets use founded-on dates.

Typical Questions

Which companies are present for this topic?
Is new company formation accelerating?
Which organizations have the strongest topic link (certainty)?

Type-specific filters

On top of the shared fact fields:

employeesCounts — size buckets such as 1-10, 51-100, 10001+
sortColumn — name (default), founded_on, or certainty
fields — response field selection (defaults include id, name, foundedOn, certainty, employeesCount)

Request Patterns

Search

{
  "topicIds": ["11111111-1111-1111-1111-111111111111"],
  "query": "northvolt",
  "certainty": 0.5,
  "employeesCounts": ["51-100", "101-250"],
  "take": 25,
  "sortColumn": "name",
  "sortDirection": "asc"
}

Time series

{
  "topicIds": ["11111111-1111-1111-1111-111111111111"],
  "resolution": "year",
  "start": "2010-01-01",
  "end": "2024-12-31"
}

Each organization includes id, name, foundedOn, certainty, and employeesCount unless you narrow fields. Time series returns labels and counts. Organizations without foundedOn are counted in withoutLabel.

Validation Notes

certainty greater than 0 requires topicIds.