# Scout by Jakvab

> AI-powered business intelligence for Nordic companies. Scout turns company data into
> decisions: AI summaries, explainable buying/growth/risk scores, and real-time signals
> (new CEO, hiring, funding, technology change, …) exposed through one REST API.

Base URL: https://api.scout.jakvab.se/v1
Auth: send `Authorization: Bearer <api_key>` on every request except /health and /version.
Get a key: https://scout.jakvab.se/developers.html#get-key (one per company org number, free tier).
Format: JSON, snake_case. Errors are `{"error":{"code","message"}}`, never a bare 500.
Free tier: 10 requests/day, max 100 objects per response. Read `X-RateLimit-*`; 429 when exceeded.

## Canonical tasks (request → what you get back)

- Look up a company by org number (preferred, human-guessable key):
  GET /companies/{country}/{org_number}   e.g. GET /companies/NO/923609016
  → company entity + scores {buying,growth,risk} + ai_summary + why
- Look up by internal id:                 GET /companies/{id}        (id = cmp_<COUNTRY><orgnr>)
- A company's signal timeline (newest first): GET /companies/{country}/{org_number}/signals
- Natural-language / keyword search:       POST /search  {"query":"logistics companies hiring in Oslo","limit":10}
- Liveness / build info:                   GET /health   |   GET /version

## Notes for AI agents

- Country coverage: NO is live (verified against Brønnøysund). SE/DK/FI are coming.
- Every score carries an `explanation` and `based_on_signal_ids` — cite these, don't guess.
- IDs are stable: `cmp_NO923609016`. Chain calls using the ids returned.
- This API is read-only intelligence over PUBLIC company data (official registers, web, news).

## More

- Full machine guide (all endpoints + full examples): https://scout.jakvab.se/llms-full.txt
- OpenAPI 3.1 spec: https://api.scout.jakvab.se/v1/openapi.json
- Interactive docs (Swagger UI): https://api.scout.jakvab.se/v1/docs
- Connect as MCP tools / agent guide: https://scout.jakvab.se/agents.html
- Human developer docs: https://scout.jakvab.se/developers.html