app.bivri.search.searchArtworks

Search artworks by keyword, tag, or author name. A 'tag:' prefix enables boolean tag search.

Details · query
Kindquery
Authoritysearch.bivri.app
Indexed

Query

query · GET

Parameters

query string

cursor

string

Opaque pagination cursor. Valid only for the sort mode it was issued under; pass it back unchanged on the next request.

limit

integer

Maximum number of artworks to return.

  • minimum: 1
  • maximum: 100
  • default: 25

q

requiredstring

Search query. Supports boolean tag search, with 'tag:xxx' terms combined by AND, OR and NOT.

sort

string

Ordering of the results. 'relevance' is by match score; 'latest' is reverse-chronological; 'popular' is by like count.

  • default: "relevance"
  • knownValues: relevance | latest | popular

Output

application/json

artworks

requiredarray
itemsref

cursor

string

Popular tags suggested when the search matched no artworks.

itemsref
Reference

#tagSuggestion

object

Properties

count

requiredinteger

tag

requiredstring

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • Get artworks carrying a tag, paginated by cursor.

  • Get the public discovery feed. Authentication is not required: a guest sees public artworks and an authenticated member also sees logged_in ones. Unlisted artworks are returned to nobody.

  • Get tag autocomplete suggestions for a prefix.

  • Get the authenticated Member's initial Artwork feed selected by their durable interest Tags. An empty interest set or no currently servable match returns an empty feed rather than silently substituting public discovery results.

  • Search hashtags by prefix, ordered by popularity (number of distinct records using the tag).