Search concepts

Search every document by name, description, tag, path and type — people, places, themes, lexemes, commandments, events, epochs, books, chapters, sources and datasets alike. All terms must match (AND), so adding a word narrows the result.

Use type to stop one collection swamping another: there are ~3,000 people AND ~3,000 themes, so an unfiltered name query is a coin flip between a person and a topic.

This searches concept metadata. For a phrase in the text of Scripture use /scripture.

get/search

Request

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

Query parameters

qstring required

One or more words, e.g. "sea galilee" or "zechariah king".

type'Person' | 'Place' | 'Theme' | 'Lexeme' | 'Commandment' | 'Event' | 'Epoch' | 'Book' | 'Chapter' | 'Source' | 'Dataset' | 'Relation Vocabulary'

Restrict to one collection. Plurals and folder names also resolve ("themes", "sa/events").

tagstring

Restrict to documents carrying this tag. See GET /tags for the vocabulary.

limitinteger
offsetinteger

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

Response

Matching concepts, best match first.

querystring required
typestring
tagstring
totalinteger required

How many matched, before paging.

offsetinteger
countinteger required

Changes

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