Search documents

Semantic search over archived City documents and meeting transcripts. Best passage per document, by meaning (not just keywords).

GET https://www.chicagopolitics.org/api/v1/search

Authorizations

HeaderValue
AuthorizationBearer <key>. Get a key; see authentication.

Query parameters

NameTypeRequiredDescription
qstringyesWhat to look for
kindstringOne of: matter, meeting, money.
doc_typestring
yearinteger
limitintegerDefault 10.

Response

200 Results: a list in data, with meta and links (see pagination).

FieldTypeDescription
titlestring
recordstring | null
kindstring
documentTypestring | null
datestring | null
scorenumber
passagestring
documentstring
linksobject

Example request

curl "https://www.chicagopolitics.org/api/v1/search?q=..." \
  -H "Authorization: Bearer $CHICAGO_POLITICS_KEY"

Errors: 400, 401, 429 (see errors).