What does 401 mean on GET /browse?

Missing, unknown or revoked key. A key minted moments ago can answer 401 until it propagates to the serving fleet.

What does 429 mean on GET /browse?

Over the per-minute rate (spent in credits), or a hard-capped key without the credits this call costs. `retry-after` is present on the rate-limit case only.

Browse without a query — GET /browse

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'.

Costs 1 credit.

Parameters

Name	Type	Description
`vertical`	string	Restrict to one vertical.
`sort`	string	recency (default) or host_rank.
`limit`	integer	Maximum hits, default 10, maximum 100 (a larger value is clamped; `total` still reports the real match count).

Responses

Status	Meaning
`200`	The recent or top-rank window.
`401`	Missing, unknown or revoked key. A key minted moments ago can answer 401 until it propagates to the serving fleet.
`429`	Over the per-minute rate (spent in credits), or a hard-capped key without the credits this call costs. `retry-after` is present on the rate-limit case only.

Response body

WebSearchResponse

Name	Type	Description
`facets`	object	Present only when facets=true
`mode`required	"keyword" \| "semantic" \| "hybrid"	The mode actually used
`partial`	boolean	true 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.
`results`required	object[]	—
`routed`required	boolean	true when the router chose the vertical, false when you named it
`total`required	integer	—
`vertical`	string \| null	The vertical actually queried

The same call over MCP

This capability is browse on the MCP server, taking the same parameters and returning the same body. A parity test in the API fails the build if the two ever diverge, so you can read either reference and use the other.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "browse",
    "arguments": {}
  }
}

Most clients build that frame for you — see Connect a client.

See Errors for what to do with each status, and Retries and backoff for which are worth repeating.

FAQ

What does 200 mean on GET /browse?: The recent or top-rank window.
What does 401 mean on GET /browse?: Missing, unknown or revoked key. A key minted moments ago can answer 401 until it propagates to the serving fleet.
What does 429 mean on GET /browse?: Over the per-minute rate (spent in credits), or a hard-capped key without the credits this call costs. `retry-after` is present on the rate-limit case only.