News Impact API

Base URL

All public API endpoints are served under /api/v1/. Requests are authenticated with an API key — see the API Keys doc for how to generate one.

News Impact Heads API Summary

Base URL

• All endpoints are under: /api/v1/

Authentication

• Header: Authorization: Bearer st_live_<your_key>
• Required scope for these endpoints: news:read
• Rate limit: 60 requests/minute per key

List impact heads

Endpoint

• GET /api/v1/news/impact-heads

Query parameters

• limit (int, 1–100, default 20): Results per page
• offset (int, default 0): Pagination offset
• sort (string): column:direction, e.g. confidence:desc, created_at:asc
• Sortable columns: id, created_at, confidence, article_id, cluster
• fields (string): Comma-separated fields to include in each item
• include_article (boolean, default true): Whether to embed the source article object
• article_id (int): Filter by article ID
• cluster (string): Filter by cluster name
• ticker (string): Filter by ticker on the source article
• from (ISO 8601): Filter created_at >= from
• to (ISO 8601): Filter created_at <= to
• min_confidence (number, 0–1): Minimum confidence score

Example request