community.lexicon.media.book.searchEditions
Search a provider's catalog using text and structured hints. Fuzzy matching, field interpretation, and ranking are provider-specific. This operation does not write user records.
Details · procedure
| Kind | procedure |
|---|---|
| Authority | book.media.lexicon.community |
| Commit rev | 3n2h5sw223y2o |
| Indexed |
Procedure
procedure · POSTInput
application/jsonauthor
stringAuthor relevance hint, interpreted by the provider.
minLength: 1
identifiers
arrayStructured identifier relevance hints; search matching and ranking are provider-defined.
minLength: 1
limit
integerMaximum number of editions to return in this page.
minimum: 1maximum: 100default: 25
offset
integerNumber of matching editions to skip in the provider's ordered result set.
minimum: 0default: 0
q
stringBroad search text, which may describe a title, contributor, description, or identifier. Matching and ranking are provider-defined.
minLength: 1
title
stringTitle relevance hint, interpreted by the provider.
minLength: 1
Output
application/jsonschema
refErrors
InvalidQuery
No nonblank q, title, author, or nonempty identifiers array was supplied.
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
Resolve one book by exact equality of at least one identifier issuer/value pair. Shared grouping identifiers may match several editions. Results are in provider-defined relevance order. This operation does not write user records.
-
Search dropped books by free text against title, authors, and publicationId. Results are de-duplicated per (publicationId, currentLocation) — multiple copies of the same publication at the same location collapse to the most recently-active copy. Ordered by last_event_at desc.
-
Find books matching the search criteria. Does not require authentication.