---
title: "List current multi-source hot topics"
method: GET
path: "/api/v1/hot-topics"
---

# List current multi-source hot topics

`GET /api/v1/hot-topics`

## Request

- Base URL: `https://lawhot.news`
- URL: `https://lawhot.news/api/v1/hot-topics`
- Auth: none declared

The current LAWHOT Top 10, ranked by multi-source coverage and discussion heat. Each item includes a one-based rank; internal and display heat values are not returned. Uses the latest successfully published ranking, normally refreshed every five minutes. Shared caches use a 60s freshness window; poll no faster than s-maxage and use If-None-Match. If an item includes links.story, it is a human-facing HTML URL: extract its final publicId path segment and call /api/v1/stories/{publicId} for timeline JSON. Never request links.story as an API. When absent, do not construct a story id.

## Headers

- `User-Agent` string
- `If-None-Match` string

## Response `200`

OK

- HotTopicsResponse
  - `schemaVersion` unknown, required
  - `count` integer, required
  - `items` HotTopic[], required
    - `rank` integer, required: One-based position in the current LAWHOT Top 10 response.
    - `id` string, required
    - `title` string, required
    - `source` object, required
      - `name` string, required
    - `links` object, required
      - `aihot` string, uri, required
      - `original` string, uri, required
      - `story` string, uri: Optional human-facing HTML URL. Extract its final publicId path segment and call /api/v1/stories/{publicId} for JSON; never request this URL as an API. Do not construct story ids when absent.
    - `sourceCount` integer, required
    - `signalCount` integer, required
    - `participantCount` integer: Distinct observed actors, unioned across editorial and signal sources; not a platform-wide population estimate.
    - `sourceNames` string[], required
    - `latestAt` string, date-time, required

## Other responses

- `304`: Not Modified
- `400`: Machine-readable problem response.
- `403`: Machine-readable problem response.
- `405`: Machine-readable problem response.
- `429`: Machine-readable problem response.
- `503`: Machine-readable problem response.

---

[API](https://skmtc.dev/lawhot/apis/lawhot-public-api.md) · [All operations](https://skmtc.dev/lawhot/apis/lawhot-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lawhot/apis/lawhot-public-api/revisions/33d44f2964aa?raw)