v1

latestSwagger 2.02026-07-17284267.5 KB
Vocabulary-specific methods

Finds concepts and collections from a vocabulary by query term

Returns a list of search results. The search is performed as a case-insensitive pattern, where an asterisk () may be used as wildcard. E.g. "cat" may return results such as "CATCH-22" and "categorization". If decoded into RDF, the result is a vocabulary fragment expressed as SKOS.

get/{vocid}/search

Path parameters

vocidstring required

a Skosmos vocabulary identifier e.g. "stw" or "yso"

Query parameters

querystring required

the term to search for e.g. "cat*"

langstring

language of labels to match, e.g. "en" or "fi"

typestring

limit search to concepts of the given type, e.g. "skos:Concept"; multiple types can be specified as a space-separated list

parentstring

limit search to concepts which have the given concept (specified by URI) as parent in their transitive broader hierarchy

groupstring

limit search to concepts in the given group (specified by URI)

maxhitsinteger

Maximum number of results to return. If not given, all results will be returned.

offsetinteger

offset where to start in ther esult set, useful for paging the result. If not given, defaults to 0.

fieldsstring

space-separated list of extra fields to include in the results. e.g. "related" or "prefLabel" or any other skos property.

uniquestring

boolean flag to indicate that each concept should be returned only once, instead of returning all the different ways it could match (for example both via prefLabel and altLabel).

Response

data of the concepts matching the search term

uristring required