REST API & Webhooks
Experiments API
Programmatically manage and evaluate controlled Difference-in-Differences (DiD) growth experiments.
The Experiments API allows engineering teams and growth workflows to manage controlled A/B and SEO experiments, isolating search algorithm shifts from genuine site changes using Difference-in-Differences (DiD) analysis.
List Experiments
GET /api/v1/experimentsQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
site_id | string (UUID) | No | Site id from GET /api/v1/projects. Returns experiments of your growth projects on that site's domain (scheme and www. ignored); 404 if the site is not yours, an empty list if it has no growth project. |
project_id | string (UUID) | No | Filter by growth project UUID (project_id on each experiment). |
status | string | No | Filter by experiment state: draft, running, completed. |
Evaluate Experiment
Trigger statistical Difference-in-Differences analysis on an active experiment using control and treatment cohorts.
POST /api/v1/experiments/{id}/evaluateRequest Body
{
"controlMetrics": {
"preImpressions": 10000,
"postImpressions": 10500,
"preConversions": 400,
"postConversions": 410
},
"treatmentMetrics": {
"preImpressions": 10000,
"postImpressions": 13200,
"preConversions": 400,
"postConversions": 580
}
}Response (200 OK)
{
"data": {
"experiment": {
"id": "exp_01j7x8a9b2c3",
"status": "completed"
},
"analysis": {
"didEstimator": 0.0155,
"liftPercentage": 38.75,
"pValue": 0.0012,
"isSignificant": true,
"confidenceInterval": [0.0062, 0.0248]
}
}
}