Query Guide


In each schema, you'll notice that each data response as a fixed set of fields.

Using the field names, you can craft powerful and versatile queries.

Query Form

Each query is in the form <field>=<value>. The <field> value is determined by the JSON payload format for the respective response.

Here's an example of where you can find <field> values.
<field_1>: string,
<field_2>: {
<field_2.1>: float,
<field_2.2>: float
"id": "001",
"coordinates": {
"latitude": 50,
"longitude": 30

Example of how to query top-level fields: id=001

Example of how to query nested fields: coordinates.latitude=50

Advanced Queries

You can also prepend the values of your search queries.

Example: coordinates.latitude=>=50

Futhermore, you can also add the more queries with the same field name.

Example: name=calculus&name=III

Here's a list of extra query operations to improve filtered search results.

OperatorStringNumerical / Boolean
Fuzzy searchEquality
<N/ALess than
<=N/ALess than or equal to
>N/AGreater than
>=N/AGreater than or equal to
(Starts withN/A
)Ends withN/A

For more context, the ~ operator especially "yolos" and tries to search within nested arrays and hard to navigate nested structures.

Example: https://nikel.ml/api/textbooks?courses=~mat135

Warning: it'll usually yield worse performance than the other operators.


Queries don't work in array types. You could try the ~ operator, but you may get items you don't want.