The cross-reference corpus in aggregate

Questions about the SHAPE of the cross-reference corpus rather than about one verse: which chapters are the hubs, which books lean on which, how much referencing crosses between the testaments.

With no argument, returns the totals plus the most-connected chapters and the strongest book-to-book pairs. Pass book for one book’s own incoming and outgoing rows, or osis for a single chapter’s rank and vote weight. Use /xrefs when you want the actual references for a passage.

Answers 503 when the aggregate has not been built — it is a build artefact, and a fresh checkout running next dev genuinely does not have it yet.

get/connections

Request

  • Base URL: https://vineverse.bible/api/v1
  • URL: https://vineverse.bible/api/v1/connections
  • Auth: none required

Query parameters

bookstring

One book, by OSIS id or slug.

osisstring

One chapter.

limitinteger
offsetinteger

Skip this many results. Compare with total in the response to page.

Response

Corpus totals, plus whichever slice was requested.

offsetinteger

Applied to every ranked list below.

topChaptersTotalinteger
topChaptersCountinteger
topChaptersobject[]
topBookPairsTotalinteger
topBookPairsCountinteger
topBookPairsobject[]
bookobject

Only when book= was given.

referencesOutTotalinteger
referencesOutCountinteger
referencesOutobject[]

This book citing others, strongest first. Only when book= was given.

referencesInTotalinteger
referencesInCountinteger
referencesInobject[]
chapterobject

Only when osis= was given.

notestring

Changes

No recorded changes to this operation across all 1 revision of this API.