Introduction

The Insighthread News API delivers financial news, tagged by event type, ticker, and sentiment — as clean, filterable JSON.

The Insighthread News API gives you programmatic access to financial news — filtered by ticker, event type, or both — as clean, stable JSON. Every article is enriched with sentiment, confidence, and a signal-strength score, plus the market price/change data at time of publish.

How it works

1. Sign up for a developer account and create an API key from your dashboard.
2. Authenticate every request with Authorization: Bearer <key>.
3. Query /v1/news with the filters you need — ticker, event type, or both — and page through results with a cursor.

Two key types are supported:

• Test keys (ik_test_...) return deterministic sample data. They never touch the live database and never count against your quota — safe to integrate against before going live.
• Live keys (ik_live_...) return real, current news and count against your daily request quota.

What you get back

Each article in /v1/news is normalized to a stable public shape, decoupled from our internal schema — so it won’t change under you as our data model evolves:

{
  "id": 48213,
  "ticker": "AAPL",
  "company_name": "Apple Inc.",
  "event_types": ["Corporate Earnings"],
  "headline": "AAPL beats Q4 earnings expectations",
  "summary": "AAPL reported Q4 revenue of $X.X billion, beating analyst consensus by 5%.",
  "published_at": "2026-08-20T14:32:00.000Z",
  "source": { "name": "Reuters", "url": "https://example.com/article" },
  "impact": {
    "direction": "positive",
    "confidence": 87,
    "signal_strength": 5
  },
  "market": {
    "price": 231.45,
    "change": 3.12,
    "change_percentage": 1.37
  }
}

Next steps