Skip to content
unlob
GET

/similar

More-like-this: given a passage id, returns its semantic neighbours from the same embedding space the index was built in.

Similar takes a hit you already have and finds what sits near it in vector space. It is the cheapest way to widen a result set without writing a second query, and because the embedding space is multilingual, the neighbours are not restricted to the language of the seed passage.

Use it when a search returned one good result and you want the rest of that conversation — rather than guessing at the query terms that would have found them.

Request

GET /similarbash
curl -H "x-api-key: $UNLOB_API_KEY" \
  "https://api.unlob.com/similar?id=p:8f2c9a&limit=10"
ParameterTypeDescription
idrequiredstringA passage id from a previous search hit.
limitinteger

default: 10

Number of neighbours.
langstringRestrict neighbours to one language.

Response

The same WebHit[] shape as /search.

From an agent

This endpoint is also exposed as the MCP tool similar, so an agent can call it without any HTTP code.

mcp: similarjson
// Find more pages like this one.
{ "id": "p:8f2c9a", "limit": 10 }

Try this endpoint

Every endpoint is available on the free tier. Get a key and run the example above unchanged.