Browse documentation
More like this
More-like-this: given a passage id from a web_search hit, return its semantic neighbours.
get
/similar Request
curl \
-H "x-api-key: $UNLOB_API_KEY" \
"https://api.unlob.com/similar?id=<id>"Behaviour
Use it when a result is nearly what you wanted — it searches by meaning from that passage rather than from words you have to guess.
Parameters
| Name | Type | Description |
|---|---|---|
idrequired | string | Seed passage id. |
limit | integer | Maximum hits, default 10. |
Responses
| Status | Meaning |
|---|---|
200 | Semantic neighbours of the seed passage. |
400 | This node has no embedder configured, so it cannot answer by meaning. |
401 | Missing, unknown or revoked key. A key minted moments ago can answer 401 until it propagates to the serving fleet. |
404 | No such passage id. |
429 | Over the per-minute rate, or past a hard-capped monthly quota. `retry-after` is present on the rate-limit case only. |
Response body
WebSearchResponse
| Name | Type | Description |
|---|---|---|
facets | object | Present only when facets=true |
moderequired | "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. |
resultsrequired | object[] | — |
routedrequired | boolean | true when the router chose the vertical, false when you named it |
totalrequired | integer | — |
vertical | string | null | The 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.