---
title: "Nearest events by centroid cosine distance (KNN)"
method: GET
path: "/api/v1/event/{slug}/related"
---

# Nearest events by centroid cosine distance (KNN)

`GET /api/v1/event/{slug}/related`

## Request

- Base URL: `https://heatpulse.cc`
- URL: `https://heatpulse.cc/api/v1/event/{slug}/related`
- Auth: none declared

## Path parameters

- `slug` string, required

## Response `200`

Related events

- object
  - `related` Event[]
    - `id` integer
    - `slug` string
    - `title` string
    - `summary` string: Original editorial summary (not a publisher excerpt)
    - `why_it_matters` string, nullable
    - `category` string
    - `tags` string[]
    - `heat` number: Cross-source heat score
    - `source_count` integer
    - `first_seen` string
    - `domains` string[]
    - `langs` string[]
    - `url` string: Canonical page path on heatpulse.cc

## Other responses

- `404`: Not found

---

[API](https://skmtc.dev/heatpulse/apis/heatpulse-agent-api.md) · [All operations](https://skmtc.dev/heatpulse/apis/heatpulse-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heatpulse/apis/heatpulse-agent-api/revisions/13aa08eaae7e?raw)