Content Queries

The SeaMist API allows you to query content based on metadata using a simple query language. To be clear, this does not query the actual content section. For that, use Search Broadly, it's made up of expressions optionally linked with AND or OR. An expression is defined as:

<property> <operator> <value>

AND is represented as && while OR is represented as ||. Combining expressions looks like this:

<expr> || <expr>
<expr> && <expr> && <expr>
(<expr> && <expr>) || <expr>

As demonstrated, you can use paranetheses to group evaluations or to override the order of precedence.

Comparison Operators

The following simple comparison operators exist.

=

Left side is exactly equal to right side.

If left side is an array, only one item in the array must match the right side value.

!=

Left side is not equal to right side.

If the left side is an array,only one item in the array must be equal to the right side value to cause this comparison to return false.

>

Left side is greater than right side.

<

Left side is less than right side.

>=

Left side is greater than or equal to right side.

<=

Left side is less than or equal to right side.

~ or contains

Left side contains right side. For example:

string_property ~ "substring"
string_property contains "substring"

If left side is an array, only one item must match the right side value.