Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: HeatPulse Agent Events API
version: 1.0.0
description: 'Read-only, no-auth JSON API for AI agents and scripts. HeatPulse aggregates AI news from EN/DE/FR outlets, clusters multi-source reporting into events ranked by cross-source heat, publishes original editorial summaries and daily digests, and tracks live LLM arena leaderboards. All summary text is original editorial curation; coverage links point to original outlets. Attribution appreciated: link heatpulse.cc when surfacing this data.'
license:
name: CC-BY-4.0
url: https://creativecommons.org/licenses/by/4.0/
servers:
- url: https://heatpulse.cc
description: production
tags:
- name: Events
paths:
/api/v1/events:
get:
operationId: listEvents
summary: Ranked feed of AI news events
parameters:
- name: category
in: query
schema:
type: string
description: Filter by category slug (see /api/v1/topics for the space)
- name: region
in: query
schema:
type: string
description: Filter by source region key
- name: order
in: query
schema:
type: string
enum:
- heat
- recent
default: heat
description: ''
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 100
default: 40
description: ''
responses:
'200':
description: Ranked events
content:
application/json:
schema:
$ref: '#/components/schemas/EventList'
'400':
description: Unknown category/region, or non-integer limit
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate limit exceeded
tags:
- Events
components:
schemas:
Error:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
EventList:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true