Skip to main content

API Reference

Query citation-grounded EU regional intelligence from your own systems. Every institutional read endpoint accepts either a browser JWT or a programmatic API key. REST API available today. Python SDK on request.

New to the API? Start with the quickstart.

Authentication

Two mechanisms, same endpoints:

  • API key (programmatic). Create one at /account/api-keys (Professional+). Send it as X-API-Key: sk_optikos_… (or Authorization: Bearer sk_optikos_…). The plaintext is shown once at creation and never stored.
  • JWT (browser). Your signed-in session token, sent as Authorization: Bearer <jwt>. Used automatically by the web app.
Base URL
https://euoptikos.com/api/v1/optikos
Example
curl -H "X-API-Key: sk_optikos_…" \
  "https://euoptikos.com/api/v1/optikos/intelligence/correlations/matrix?nuts_code=DE21"
Rate limits

Tier daily caps + per-key minute/hour/day buckets, and the X-RateLimit-* response headers.

Read more
Webhooks

HMAC-signed event delivery, the envelope schema, signature verification, retries + circuit-breaker.

Read more

Full API specification

The complete OpenAPI 3 spec: every endpoint, parameter, and response schema. Load it into Swagger UI, Postman, or a client generator.

Explore the full API