Developers
Optikos exposes a documented REST API. Every response carries citations to primary sources; every value resolves to a row you can verify. REST API available today. Python SDK on request.
Looking for the full reference (rate limits, webhooks, and the complete OpenAPI spec)? Open the API reference.
Python SDK
A thin, typed client over the REST API is available on request. Until it is published, integrate directly against the REST endpoints below.
Python SDK: on request. Ask your account contact for early access.
REST API
Base URL for the REST API:
https://euoptikos.com/api/v1/optikos
JSON envelopes ({ data, meta, error? }), tier-gated, RLS-isolated.
Authentication
Generate an API key at /account/api-keys (Professional tier or higher). Pass it as a Bearer token:
Authorization: Bearer sk_optikos_xxxxxxxxxxxxxxxx
- Professional: 1 key, 10,000 calls/day
- Institutional: 10 keys, 100,000 calls/day
- Anonymous (no key): public-shared data only, rate-limited per IP
curl examples
curl -H "Authorization: Bearer $OPTIKOS_API_KEY" \ https://euoptikos.com/api/v1/optikos/regions/DE300/profile
curl -H "Authorization: Bearer $OPTIKOS_API_KEY" \ 'https://euoptikos.com/api/v1/optikos/compare?regions=DE,FR&dataset=demo_r_pjangrp3'
curl -X POST -H "Authorization: Bearer $OPTIKOS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"region_nuts_code":"DE300","briefing_type":"profile_summary"}' \
https://euoptikos.com/api/v1/optikos/briefingscurl -H "Authorization: Bearer $OPTIKOS_API_KEY" \ https://euoptikos.com/api/v1/optikos/export/bulk/demo_r_pjangrp3.csv -o berlin_pop.csv
OpenAPI specification
The curated OpenAPI 3 spec covers every published/api/v1/optikos/endpoint: load it into Swagger UI, Postman, or a client generator (R / Stata / Go / etc.).
Higher tier, higher throughput
The API surface is the same on every tier. What changes is rate-limit + access to AI products + bulk export.