Concept

Statements

Annotated passages on source articles: what a person said, and what others said about them.

Annotation types

TypeMeaning
speechThe person speaking about themselves or their plans
feedbackAnother person or a body, such as a board, speaking about them
recommendationA recommendation made about the person
reviewAn assessment of the person's performance

By and about

On a profile, statements split two ways. by holds what the person said. about holds what others said about them. get_person returns both from the person's five most recent annotated articles.

Repeated annual statements

Some statements recur every year in near-identical words. By default the profile articles endpoint folds a repeat from the same organisation, type and speaker into the most recent one, with a history_count. Pass collapse=none to get every one.

Offsets

Each annotation carries start and end offsets into the article content, counted in UTF-16 code units. JavaScript string indices use the same units, so content.slice(start, end) returns the passage.

Related