DEVELOPER PLATFORM · API V1

Build with source-backed clinic intelligence.

Use the same governed, read-only data surface that powers FastComps. Every observation retains its public evidence URL; raw SQL and internal database infrastructure are never exposed.

Authentication. The documentation and OpenAPI contract are public. Data and conversation requests use the secure FastComps session cookie and return 401 outside an authenticated session. Dedicated scoped API keys can be added later without exposing the database.

API resources

Market overview

Read verified competitors, locations, observations and retained sources.

GET /api/overview

Treatment treemap

Country → treatment type → treatment, sized by observations and coloured by relative price level.

GET /api/treemap

Competitors

Search verified clinic competitors and their attributable footprint.

GET /api/competitors

Competitor detail

Drill into a provider’s locations, treatment prices and relative price levels.

GET /api/competitors/{competitor_id}

Clinic locations

Read geocoded, source-backed provider locations used by the market map.

GET /api/locations

Price observations

Read captured treatments, prices, currencies and readable evidence links.

GET /api/observations

Coverage

Inspect collection status and evidence depth across all 30 EEA markets.

GET /api/coverage

Evidence register

Review retained public sources and freshness metadata.

GET /api/evidence

Conversation stream

Stream governed analysis as progress, plan, visual, token, citation and completion events.

POST /api/assistant/stream

Conversations

List the signed-in user’s persisted chat history.

GET /api/threads

Quick start

curl 'https://comps.fastsme.com/api/overview?country=EE' \
  --cookie 'fastcomps_session=<signed-session>'

# Streamed conversational analysis
curl 'https://comps.fastsme.com/api/assistant/stream' \
  --header 'Content-Type: application/json' \
  --cookie 'fastcomps_session=<signed-session>' \
  --data '{"question":"Compare clinic pricing in Estonia","country":"EE","workspace":"chat"}'

Streaming event contract

The SSE response emits progress, plan, visual, token, citations, and done events. Plans are constrained to allowlisted metrics and dimensions; the server compiles and executes bounded read-only queries internally.