Score an SEO experiment
get_experiment_resultsScores one SEO experiment: assigns the property's landing pages to the experiment's control and variant URL groups, then compares each variant against the control (group 0) on click growth period-over-period. Returns per-group clicks/impressions/CTR (with a confidence interval) and an impression-weighted average position, plus for each variant the uplift in growth (percentage points) with its CI, a significance test of that growth difference (significant exactly when the CI excludes 0), the winner, and a low-power warning. ctrPValue is a separate test of the CTR difference, for reference only. The comparison window is the prior same-length period. Reads the ClickHouse warehouse when available, else the live Search Console API.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| endDate | No | Optional. Window end as YYYY-MM-DD (e.g. 2026-05-31). You do NOT need to know today's date or the latest available date: omit this and the server uses the latest settled Search Console date (data lags ~2-3 days behind today). Never pass null or the string "null". | |
| siteUrl | Yes | ||
| startDate | No | Optional. Window start as YYYY-MM-DD (e.g. 2026-05-03). You do NOT need to know today's date. Omit BOTH startDate and endDate to analyze the last 28 settled days automatically (Search Console data lags ~2-3 days). Never pass null or the string "null". | |
| experimentId | Yes | The experiment id from list_experiments. | |
| confidenceLevel | No | Confidence level for the significance test and CIs (default 0.95). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| range | No | ||
| groups | No | ||
| siteUrl | No | ||
| truncated | No | ||
| comparison | No | ||
| dataSource | No | ||
| experiment | No | ||
| comparisons | No | ||
| truncationNote | No | ||
| windowNormalization | No |