Quickstart

Your first /v1/query in 5 minutes.

1 — Get an API key

Sign in to your Forum Atlas workspace, navigate to API keys, and click New API key. Scope it to query:read for the quickstart (add brief:read and forecast:read when you start pulling briefs and forecasts). Endpoint availability and monthly caps vary by plan — deliberate mode, forecast generation, and causal traces need Team or above (see tier gates).

2 — Make your first call

bash

curl -X POST https://api.forumatlas.com/v1/query \
  -H "Authorization: Bearer $FORUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sectors": ["cyber"],
    "persona": "vendor_competitive_intel",
    "query": "What did Snyk announce in the past week?"
  }'

3 — Read the response

json

{
  "request_id": "req_abc123",
  "mode": "speculative",
  "headline": "Snyk extends Series H at a flat valuation",
  "lede": "Snyk announced a $50M Series H extension on 2026-05-20...",
  "sections": [
    {
      "heading": "What happened",
      "body": "Snyk today announced a $50 million extension to its Series H [1]...",
      "claims": []
    }
  ],
  "sources": [
    {
      "index": 1,
      "title": "Snyk — Series H Extension Announcement",
      "url": "https://snyk.io/press/series-h-extension-2026",
      "publisher": "Snyk",
      "date": "2026-05-20"
    }
  ],
  "confidence": "medium",
  "validator": { "passed": true, "matched_claims": 3, "total_claims": 3, "failures": [] },
  "usage": { "tokens": 4218, "cost_usd": 0.0042, "latency_ms": 1840 }
}

4 — Next steps

Wire webhooks for anomaly alerts into your own pipeline.

Use the TypeScript SDK (other languages talk to the same REST API).

Browse the recipes for "build a daily Slack digest in 50 lines."

1 — Get an API key

curl -X POST https://api.forumatlas.com/v1/query \ -H "Authorization: Bearer $FORUM_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "sectors": ["cyber"], "persona": "vendor_competitive_intel", "query": "What did Snyk announce in the past week?" }'

3 — Read the response

json

{
  "request_id": "req_abc123",
  "mode": "speculative",
  "headline": "Snyk extends Series H at a flat valuation",
  "lede": "Snyk announced a $50M Series H extension on 2026-05-20...",
  "sections": [
    {
      "heading": "What happened",
      "body": "Snyk today announced a $50 million extension to its Series H [1]...",
      "claims": []
    }
  ],
  "sources": [
    {
      "index": 1,
      "title": "Snyk — Series H Extension Announcement",
      "url": "https://snyk.io/press/series-h-extension-2026",
      "publisher": "Snyk",
      "date": "2026-05-20"
    }
  ],
  "confidence": "medium",
  "validator": { "passed": true, "matched_claims": 3, "total_claims": 3, "failures": [] },
  "usage": { "tokens": 4218, "cost_usd": 0.0042, "latency_ms": 1840 }
}