Skip to content
unlob

limit

integerdefault: 10

Number of hits to return. Zero returns the count only.

limit=0 is worth knowing about: it returns total without any results, which is how you cheaply test whether a query has coverage before committing to it.

Example

limitbash
curl -H "x-api-key: $UNLOB_API_KEY" \
  "https://api.unlob.com/search?q=obscure+topic&limit=0"

Common questions

What does the limit filter do?

Number of hits to return. Zero returns the count only.

When should I use limit?

Always. `limit=0` for coverage probes.

Filters are free

Every filter is evaluated against a stored field, so it narrows the candidate set before scoring — a filtered query is often faster than an unfiltered one.