---
title: "Semantically similar pages"
method: GET
path: "/api/pages/{id}/related"
tags: ["pages", "search"]
---

# Semantically similar pages

`GET /api/pages/{id}/related`

## Request

- Base URL: `https://telawiki.com`
- URL: `https://telawiki.com/api/pages/{id}/related`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `tela_session`

Reads stored embeddings, so unlike `/api/rag/search` it needs no live embedder and never returns 503 — but it yields an empty list for a page that has not been indexed.

## Query parameters

- `limit` integer

## Response `200`

Related pages, most similar first.

- object
  - `related` object[], required
    - `page_id` integer, required
    - `space_id` integer, required
    - `title` string, required
    - `similarity` number, required: Cosine similarity.
    - `updated_at` string, required

## Other responses

- `400`: Malformed request. `code` is usually `bad_request` or `invalid_json`.
- `403`: `forbidden` (no access, or the role is too low), `viewer_no_write`, `api_key_scope` (the token's scope forbids this method), or `api_key_space_scope` (the token is pinned to another space).
- `500`: `internal` — server error.

---

[API](https://skmtc.dev/telawiki/apis/tela-rest-api.md) · [All operations](https://skmtc.dev/telawiki/apis/tela-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/telawiki/apis/tela-rest-api/revisions/f316f31f6fcb?raw)