Developer docs · v1

The Scout API.
By developers, for developers.

A clean, predictable REST API over Nordic company intelligence.

Try the API

Paste your API key and run a request against the live API. Your key stays in this browser tab — it's never stored or sent anywhere but the Scout API.

Examples
api.scout.jakvab.se/v1

Prefer the full interactive reference? Swagger UI ↗

Quickstart

Every non-public route needs a Bearer key.

quickstart.sh
curl https://api.scout.jakvab.se/v1/companies/cmp_5566778899 \
  -H "Authorization: Bearer $SCOUT_KEY"
quickstart.py
import os, httpx

r = httpx.get(
    "https://api.scout.jakvab.se/v1/companies/cmp_5566778899",
    headers={"Authorization": f"Bearer {os.environ['SCOUT_KEY']}"},
)
print(r.json()["scores"])  # {'buying': 87, 'growth': 72, 'risk': 24}
quickstart.js
const res = await fetch(
  "https://api.scout.jakvab.se/v1/companies/cmp_5566778899",
  { headers: { Authorization: `Bearer ${process.env.SCOUT_KEY}` } }
);
const company = await res.json();
console.log(company.scores); // { buying: 87, growth: 72, risk: 24 }

Authentication

Send your key in the Authorization header.

auth
Authorization: Bearer sk_live_a1b2c3…

# 401 if missing or revoked:
{ "error": { "code": "unauthorized", "message": "Invalid API key" } }

Endpoints

A selection of v1.

GET/companies/{id}Full company — entity + scores + summary
GET/companies/{id}/signalsSignal timeline, newest first
GET/companies/{id}/similarNearest companies by embedding + structure
POST/searchKeyword / semantic / hybrid search
GET/signalsQuery signals across all companies
POST/alertsSubscribe to a signal pattern
POST/api-keysCreate a key (full value shown once)
DEL/api-keys/{id}Revoke a key

Errors

Never a bare 500. Every error shares one shape.

error.json
{
  "error": {
    "code": "not_found",
    "message": "Company not found"
  }
}

Webhooks

Subscribe to a signal pattern and Scout delivers a signed webhook.

webhook.json
# Header: X-Scout-Signature: sha256=…  (HMAC over the body)
{
  "event": "signal.matched",
  "alert_id": "alr_42",
  "signal": { "type": "new_ceo", "company_id": "cmp_55…" },
  "company": { "name": "Nordlast Logistik AB" }
}
Start for free

Get an API key

Enter your company number and work email — the key is emailed to you.

One key per registration number. Work email only.