This version of the OpenSearch documentation is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.

Term-level queries

Term-level queries search an index for documents that contain an exact search term. Documents returned by a term-level query are not sorted by their relevance scores.

When working with text data, use term-level queries for fields mapped as keyword only.

Term-level queries are not suited for searching analyzed text fields. To return analyzed fields, use a full-text query.

Term-level query types

The following table lists all term-level query types.

Query typeDescription
termSearches for documents containing an exact term in a specific field.
termsSearches for documents containing one or more terms in a specific field.
terms_setSearches for documents that match a minimum number of terms in a specific field.
idsSearches for documents by document ID.
rangeSearches for documents with field values in a specific range.
prefixSearches for documents containing terms that begin with a specific prefix.
existsSearches for documents with any indexed value in a specific field.
fuzzySearches for documents containing terms that are similar to the search term within the maximum allowed Levenshtein distance. The Levenshtein distance measures the number of one-character changes needed to change one term to another term.
wildcardSearches for documents containing terms that match a wildcard pattern.
regexpSearches for documents containing terms that match a regular expression.