# reopt data (리옵트 데이터)

> A product analytics platform. You send product events to it and it returns funnels, retention curves, paths, segments, dashboards, and condition-based alerts. Operated by Reopt; the interface language is Korean, the API is English.

The dashboard lives at https://data.reopt.ai/dashboard behind a Reopt OAuth session. Everything an unauthenticated client can reach is listed below. Plans: Demo (₩0) · Starter (₩12,000/월) · Growth (₩49,000/월) · Scale (맞춤).

## When to use reopt data

Reach for this service when a task involves any of the following. Anything outside this list is almost certainly the wrong tool.

- Sending product usage events from a web, mobile, or server application to an analytics backend. Use `POST /api/track`; it is the only write endpoint and the only one that accepts API-key style credentials.
- Answering behavioural product questions — conversion through a funnel, retention by cohort, the paths users take, how segments differ, which events fire how often.
- Watching a product's event stream in real time, or getting alerted when a metric crosses a condition.
- Pulling a project's collected events back out in bulk as CSV or JSON Lines, for a warehouse or an ad-hoc analysis.
- Reading how the platform works — ingestion contract, credit-based billing, data retention, analytics backend options.

How to call it:

1. Read [the OpenAPI spec](https://data.reopt.ai/openapi.json) first. It is the contract; this file is only a map.
2. To write events you need a project write key (browser) or a client id and secret (server). Both are issued from project settings in the dashboard — there is no self-serve key API, so a human has to create the project once.
3. To read data back you need a dashboard session cookie. Ingestion credentials cannot read data; that separation is deliberate.
4. Retries are safe: `eventId` is the idempotency key, and replaying an accepted event counts as a duplicate rather than a second event.

## API

- [OpenAPI 3.1 specification](https://data.reopt.ai/openapi.json): full request and response schemas, error bodies, and security schemes for every public endpoint.
- `POST /api/track`: ingest one event or a batch. Auth: `reopt-write-key`, or `reopt-client-id` + `reopt-client-secret`. Max body 512KB, 1000 requests/minute per project.
- `GET /api/export/events`: bulk export as CSV or JSON Lines. Auth: dashboard session cookie. 10 requests/minute per user.
- `GET /api/realtime/{projectId}`: server-sent stream of live events and rolling statistics. Auth: dashboard session cookie.
- `GET /api/docs/search?query=...`: full-text search over this documentation. No auth.
- `GET /api/health`: dependency health report. Returns 503 when a dependency is down. No auth.

Errors from `/api/*` are always JSON, never HTML.

The official client is `@reopt-ai/data-sdk` on npm (entry points `.`, `./react`, `./node`, `./nextjs`). It wraps `POST /api/track` with batching, retries, and consent handling; it does not cover the read endpoints. There is no official CLI.

## Documentation

- [시작하기](https://data.reopt.ai/docs): 리옵트 데이터에서 조직을 만들고, 이벤트를 수집하고, 분석 루프를 운영하기까지의 전체 흐름을 안내합니다.
- [서비스 개요](https://data.reopt.ai/docs/overview/service-overview): 조직, 프로젝트, 분석 화면, 운영 루프가 리옵트 데이터 안에서 어떻게 이어지는지 설명합니다.
- [빠른 연동](https://data.reopt.ai/docs/workspace/quickstart): 프로젝트 생성 후 브라우저와 서버리스 route handler에 첫 이벤트를 붙이고, 수집 성공을 확인합니다.
- [추적 설정](https://data.reopt.ai/docs/workspace/tracking-setup): 프로젝트를 만든 뒤 브라우저, React, 서버리스 환경에 이벤트 수집을 붙이는 방법을 안내합니다.
- [분석 워크벤치](https://data.reopt.ai/docs/project-workspace/analysis-workbench): 분석 질문에 맞는 화면을 고르고, 탐색 결과를 리포트와 운영 루프로 연결합니다.
- [아키텍처](https://data.reopt.ai/docs/platform/architecture): Turborepo 모노레포 구조, 앱 경계, 데이터 계층, docs 위치를 정리합니다.
- [서비스 이해](https://data.reopt.ai/docs/overview): 리옵트 데이터가 어떤 계층과 화면으로 구성되는지 먼저 살펴봅니다.
- [서비스 맵](https://data.reopt.ai/docs/overview/service-map): 앱 라우트와 화면 기준으로 리옵트 데이터의 서비스 지도를 확인합니다.
- [플랫폼과 개발](https://data.reopt.ai/docs/platform): 수집 파이프라인, 서비스 경계, 엔드포인트, 아키텍처, 로컬 개발 흐름을 운영 관점에서 안내합니다.
- [분석 백엔드 선택](https://data.reopt.ai/docs/platform/analytics-backend): ClickHouse와 MotherDuck 중 분석 백엔드를 선택하고, 로컬/운영 환경변수를 설정합니다.
- [리텐션 cohortMode 기본값 변경](https://data.reopt.ai/docs/platform/changelog-cohort-mode): 리텐션 코호트 기본 정의가 first-ever로 바뀌며 기존 차트 수치가 달라질 수 있는 이유를 설명합니다.
- [데이터 수집과 거버넌스](https://data.reopt.ai/docs/platform/data-collection-and-governance): `/api/track` 수집, raw event 저장, materialization, 이벤트 거버넌스, retention 대상을 설명합니다.
- [환경변수와 배포](https://data.reopt.ai/docs/platform/environment-and-deployment): 로컬, Vercel, 분리 서비스 배포에서 필요한 환경변수와 운영 토글을 정리합니다.
- [로컬 개발](https://data.reopt.ai/docs/platform/local-development): 웹 앱, docs, worker, 분리 서비스를 로컬에서 실행하고 검증하는 명령을 정리합니다.
- [서비스 Plane과 엔드포인트](https://data.reopt.ai/docs/platform/service-planes-and-endpoints): Next.js control plane과 분리 가능한 data plane 서비스, 주요 API endpoint의 역할을 정리합니다.
- [프로젝트 워크스페이스](https://data.reopt.ai/docs/project-workspace): 프로젝트 홈과 분석 화면을 사용해 질문을 지표와 운영 액션으로 바꾸는 흐름을 안내합니다.
- [획득과 경로 분석](https://data.reopt.ai/docs/project-workspace/acquisition-and-path): 유입 채널 성과와 실제 사용자 경로를 함께 보며 유입 품질을 해석합니다.
- [비교, 브레이크다운, 쿼리](https://data.reopt.ai/docs/project-workspace/compare-breakdown-query): 세그먼트 비교, 속성별 분해, SQL 쿼리로 준비된 화면을 넘어선 질문을 확인합니다.
- [대시보드와 리포트](https://data.reopt.ai/docs/project-workspace/dashboards-and-reporting): 프로젝트 홈에서 핵심 지표를 확인하고, 반복해서 볼 분석 결과를 리포트와 대시보드로 저장합니다.
- [이벤트 카탈로그](https://data.reopt.ai/docs/project-workspace/event-catalog): 수집된 이벤트를 전환, 태그, 상태, 카테고리로 정리해 팀의 공통 분석 언어를 만듭니다.
- [퍼널](https://data.reopt.ai/docs/project-workspace/funnel): 단계 이벤트를 연결해 전환율과 이탈 지점을 확인합니다.
- [실시간, 인사이트, 알림](https://data.reopt.ai/docs/project-workspace/realtime-insights-alerts): 실시간 이벤트, 이상 탐지, 조건 기반 알림을 연결해 운영 반응 루프를 만듭니다.
- [리텐션](https://data.reopt.ai/docs/project-workspace/retention): cohort matrix와 interval 설정으로 사용자가 다시 돌아오는지 확인합니다.
- [세션 탐색](https://data.reopt.ai/docs/project-workspace/sessions): 방문 단위 행동 흐름을 확인하고, 익명/식별 세션과 개별 세션 타임라인을 분석합니다.
- [설정과 DevTools](https://data.reopt.ai/docs/project-workspace/settings-and-devtools): 프로젝트 설정, 도메인, 보존 정책, 저장소 사용량, DevTools 시나리오를 관리합니다.
- [사용자와 세그먼트](https://data.reopt.ai/docs/project-workspace/users-and-segments): 개별 사용자 행동을 확인하고, 재사용 가능한 사용자 집합을 만들어 분석 화면에 적용합니다.
- [워크스페이스](https://data.reopt.ai/docs/workspace): 조직과 프로젝트를 만들고, 추적을 시작하고, 비용과 보존 정책을 운영하는 방법을 안내합니다.
- [비용과 보존 정책](https://data.reopt.ai/docs/workspace/cost-and-retention): 조직 단위 사용량과 비용, 프로젝트 단위 보존 정책과 cleanup 흐름을 관리합니다.
- [조직과 프로젝트](https://data.reopt.ai/docs/workspace/organizations-and-projects): 워크스페이스 홈과 조직 홈에서 조직과 프로젝트를 만들고 이동하는 흐름을 안내합니다.

## Site

- [Product overview and pricing](https://data.reopt.ai/)
- [About](https://data.reopt.ai/about): what the service does and how data flows through it.
- [Contact](https://data.reopt.ai/contact): support and privacy contacts.
- [Terms of service](https://data.reopt.ai/terms): plans, usage limits, data ownership.
- [Privacy policy](https://data.reopt.ai/privacy): what is collected, where it is stored, how long it is kept.
- [Sitemap](https://data.reopt.ai/sitemap.xml)
- [Full documentation as one file](https://data.reopt.ai/llms-full.txt)
- [Reopt, the company](https://company.reopt.ai)

## Notes for agents

- Every public page answers `Accept: text/markdown` with a Markdown rendering, and the same content is available by appending `.md` to the path — for example https://data.reopt.ai/docs/workspace/quickstart.md.
- There is no self-serve API key endpoint and no sandbox host. To evaluate the product without collecting data, sign up and use the demo workspace, which carries example data and every analysis screen at no cost.
- Do not assume workspace-specific data (project ids, event names, metrics) is reachable from this file. It is not; it requires a session.
- Support: support@reopt.ai