---
title: "GET /v1/items/{id}"
method: GET
path: "/v1/items/{id}"
---

# GET /v1/items/{id}

`GET /v1/items/{id}`

## Request

- Base URL: `https://hottub.news`
- URL: `https://hottub.news/v1/items/{id}`
- Auth: none declared

## Path parameters

- `id` string, required

## Response `200`

One item

- Item
  - `id` string, required: n_ news (derived from canonical URL), s_ sponsored
  - `seq` integer: Monotonic sync cursor
  - `kind` 'article' | 'press_release' | 'official' | 'community' | 'research' | 'sponsored', required
  - `title` string, required
  - `url` string, uri, required
  - `summary` string
  - `published` string, date-time, required
  - `seen` string, date-time, required
  - `lang` string
  - `country` string
  - `source` object, required
    - `id` string, required
    - `name` string, required
    - `domain` string
  - `via` string, required
  - `topics` string[]
  - `authors` string[]
  - `image` string, uri
  - `mentions` integer: Sources that linked this exact URL (omitted when 1)
  - `story` string
  - `related` integer: sort=hot / collapse=story: other reports of this story
  - `score` number: q= relevance
  - `category` 'arts-culture-entertainment' | 'conflict-war' | 'crime-law' | 'disaster-accident' | 'economy-business' | 'education' | 'environment' | 'health' | 'human-interest' | 'labour' | 'lifestyle-leisure' | 'politics' | 'religion' | 'science-technology' | 'society' | 'sport' | 'weather'
  - `category_p` number
  - `category2` string
  - `sentiment` 'negative' | 'neutral' | 'positive'
  - `tone` number
  - `political` number
  - `disclosure` object
    - `paid` unknown, required
    - `label` string, required
    - `campaign` string, required
    - `sponsor` object, required
      - `id` string, required
      - `name` string, required
      - `url` string
      - `verified` boolean, required

## Other responses

- `404`: Error with a fix-it message

---

[API](https://skmtc.dev/hottub/apis/hottub-news.md) · [All operations](https://skmtc.dev/hottub/apis/hottub-news/llms.txt) · [OpenAPI document](https://skmtc.dev/hottub/apis/hottub-news/revisions/cf50ab224171?raw)