Getting Started

Create a developer account

Sign up for a developer account on the Insighthread dashboard. Signing up automatically provisions your developer record — no separate onboarding step needed.

Create an API key

From your dashboard, create a key under API Keys. Start with a test key (ik_test_...) — it returns deterministic sample data and never counts against your quota, so you can integrate safely before switching to a live key.

The raw key is shown once, at creation time. Only its hash is stored, so if you lose it you’ll need to revoke it and create a new one.

Make your first request

Call /v1/ping to confirm your key works:

curl https://newsapi.insighthread.com/api/v1/ping \
  -H "Authorization: Bearer ik_test_xxxxxxxxxxxxxxxx"

{
  "ok": true,
  "message": "Authenticated as \"my test key\"",
  "client": { "id": "...", "label": "my test key", "prefix": "ik_test_xxxxxxxx" },
  "served_at": "2026-08-24T10:15:00.000Z"
}

Fetch news

Call /v1/news for a page of articles:

curl "https://newsapi.insighthread.com/api/v1/news?ticker=AAPL&limit=5" \
  -H "Authorization: Bearer ik_test_xxxxxxxxxxxxxxxx"

See the API Reference for every filter and the full response shape.

Next steps

Authentication

Key types, headers, and error responses.

API Reference

ping, events, and news endpoints in detail.