---
title: "Ranked feed of AI news events"
method: GET
path: "/api/v1/events"
---

# Ranked feed of AI news events

`GET /api/v1/events`

## Request

- Base URL: `https://heatpulse.cc`
- URL: `https://heatpulse.cc/api/v1/events`
- Auth: none declared

## Query parameters

- `category` string
- `region` string
- `order` 'heat' | 'recent'
- `limit` integer

## Response `200`

Ranked events

- EventList
  - `order` string
  - `count` integer
  - `events` 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

- `400`: Unknown category/region, or non-integer limit
- `429`: Rate limited (120 req/min/IP)

---

[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)