v1

latestOpenAPI 3.0.1The University of Illinois/NCSA Open Source License (NCSA)2026-07-1727211165.4 KB
search

Perform a basic search

Return files, datasets and/or collections matching query criteria. Search can be filtered by a specific resource ID, limited to tags or specific metadata fields.

get/search

Query parameters

querystring

String term to search for. Can include regular expressions using Elasticsearch syntax.

resource_typestring

Restrict search results to "file", "dataset", or "collection".

datasetidstring

Return only resources belonging to a specific dataset.

collectionidstring

Return only resources belonging to a specific collection.

spaceidstring

Return only resources belonging to a specific space.

folderidstring

Return only resources belonging to a specific folder.

fieldstring

Restrict search to a specific metadata field, e.g. "Alternative Title".

tagstring

Search for resources with a specific tag.

frominteger

Starting index of first result; useful for pagination.

sizeinteger

Number of search results to include; useful for pagination.

pageinteger

An alternative to "from" for pagination. Return the Nth page assuming "size" items per page.

sortstring

A date or numeric field to sort by. If order is given but no field specified, created date is used.

order'asc' | 'desc'

Whether to scored in asc (ascending) or desc (descending) order. If a field is given without an order, asc is used.

Response

OK

All 272 operations