unlob Docs
Browse documentation

Browse without a query

Browse without a query: the most-recent (or top-host-rank) passages, optionally within a vertical.

get /browse

Request

curl \
  -H "x-api-key: $UNLOB_API_KEY" \
  "https://api.unlob.com/browse"

Behaviour

For 'what is new here' rather than 'find me X'.

Parameters

NameTypeDescription
verticalstringRestrict to one vertical.
sortstringrecency (default) or host_rank.
limitintegerMaximum hits, default 10.

Responses

StatusMeaning
200The recent or top-rank window.
401Missing, unknown or revoked key. A key minted moments ago can answer 401 until it propagates to the serving fleet.
429Over the per-minute rate, or past a hard-capped monthly quota. `retry-after` is present on the rate-limit case only.

Response body

WebSearchResponse

NameTypeDescription
facetsobjectPresent only when facets=true
moderequired"keyword" | "semantic" | "hybrid"The mode actually used
partialbooleantrue when at least one shard failed or timed out — the answer is short because a slice of the corpus was unreachable, NOT because that is all there is. Never treat a partial result as complete.
resultsrequiredobject[]
routedrequiredbooleantrue when the router chose the vertical, false when you named it
totalrequiredinteger
verticalstring | nullThe vertical actually queried

The same call over MCP is a tool with these parameter names unchanged. See Errors for what to do with each status.