Skip to content

Entities

Entities are canonical records for people, places, and organizations identified across project articles. Entity endpoints let you search the catalog, retrieve detail, and explore mention evidence and Stylebook connections — starting from the entity rather than from a single article.

Entity types

Entity Overview
People People — get, list and search, mentions, connections
Locations Locations — get, list and search, geographic search, mentions, connections
Organizations Organizations — get, list and search, mentions, connections

Shared pattern

Each entity type follows the same structure:

Endpoint type Use when
Detail Show one canonical record
List and search Find records by name, type, or filters
Mentions Load paginated mention evidence
Articles Load paginated stories mentioning the entity
Connections Load Stylebook relationships

Entity ids are UUID strings. Canonical records include a stylebook_slug identifying which Stylebook catalog they belong to. List, detail, and geographic search responses include counts with project-scoped mentions and stories totals.

For person_type, organization_type, and location_type catalogs, see Entity Meta.

Article-first vs entity-first

You can reach entity data two ways:

Use article-first flows when you already have a story in context. Use entity-first flows when you are building person, place, or organization directories, profile pages, or relationship views.