API Docs — GroupResearch

Authentication

Include your key in every request header:

Authorization: Bearer grk_your_key_here

Rate limit: 100 requests/hour per key

Aggregate Data Endpoint

Returns aggregate stats (avg, min, max) for each question in the experiment.

Query parameters (optional)

Example response

{
  "experiment": {
    "slug": "sleep-quality",
    "title_en": "Sleep Quality Experiment",
    "title_ar": "تجربة جودة النوم",
    "duration_days": 21
  },
  "stats": {
    "total_enrollments": 842,
    "completed": 318
  },
  "aggregates": {
    "sleep_hours": { "count": 5291, "avg": 6.8, "min": 2, "max": 12 },
    "energy_level": { "count": 5291, "avg": 6.2, "min": 1, "max": 10 },
    "felt_rested":  { "count": 5291, "true_count": 3104 }
  },
  "period": "all-time"
}