Skip to main content
GET
/
3
/
abtests
curl
curl --request GET \
  --url 'https://analytics.us.algolia.com/3/abtests?offset=0&limit=10&indexPrefix=dev_&indexSuffix=_development&direction=desc' \
  --header 'accept: application/json' \
  --header 'x-algolia-api-key: ALGOLIA_API_KEY' \
  --header 'x-algolia-application-id: ALGOLIA_APPLICATION_ID'
{
  "abtests": [
    {
      "abTestID": 224,
      "updatedAt": "2023-06-15T15:06:44.400601Z",
      "createdAt": "2023-06-15T15:06:04.249906Z",
      "endAt": "2023-06-17T00:00:00Z",
      "stoppedAt": "2023-06-15T15:06:44.400601Z",
      "name": "Custom ranking sales rank test",
      "status": "active",
      "variants": [
        {
          "description": "Current production index",
          "estimatedSampleSize": 0,
          "index": "delcourt_production",
          "trafficPercentage": 60,
          "metrics": [
            [
              {
                "name": "addToCartCount",
                "updatedAt": "2025-06-15T15:06:44.400601Z",
                "value": 5,
                "pValue": 0.01
              },
              {
                "name": "clickThroughRate",
                "updatedAt": "2025-05-15T17:52:15.644906Z",
                "value": 0.20869847452125934,
                "pValue": 0.004
              },
              {
                "name": "revenue",
                "dimension": "USD",
                "updatedAt": "2025-05-15T17:52:15.644906Z",
                "value": 1200.5,
                "pValue": 0.04,
                "metadata": {
                  "winsorizedValue": 80.2
                }
              },
              {
                "name": "revenue",
                "dimension": "EUR",
                "updatedAt": "2025-05-15T17:52:15.644906Z",
                "value": 999.66,
                "pValue": 0.04,
                "metadata": {
                  "winsorizedValue": 888.8
                }
              }
            ]
          ],
          "metadata": {
            "filterEffects": {
              "outliers": {
                "usersCount": 1,
                "trackedSearchesCount": 237
              },
              "emptySearch": {
                "usersCount": 1,
                "trackedSearchesCount": 237
              }
            }
          },
          "customSearchParameters": {
            "enablePersonalization": true,
            "personalizationImpact": 50
          }
        }
      ],
      "configuration": {
        "minimumDetectableEffect": {
          "size": 0.5,
          "metric": "addToCartRate"
        },
        "filters": [
          {
            "domain": "abtesting",
            "name": "isOutlier",
            "trackEffects": true,
            "includes": true
          }
        ],
        "errorCorrection": "bonferroni"
      },
      "migratedAbTestID": 224
    }
  ],
  "count": 10,
  "total": 12
}
Required ACL: analytics

Authorizations

​
x-algolia-application-id
string
header
required

Your Algolia application ID.

​
x-algolia-api-key
string
header
required

Your Algolia API key with the necessary permissions to make the request. Permissions are controlled through access control lists (ACL) and access restrictions. The required ACL to make a request is listed in each endpoint's reference.

Query Parameters

​
offset
integer
default:0

Position of the first item to return.

Required range: x >= 0
​
limit
integer
default:10

Number of items to return.

​
indexPrefix
string

Index name prefix. Only A/B tests for indices starting with this string are included in the response.

​
indexSuffix
string

Index name suffix. Only A/B tests for indices ending with this string are included in the response.

​
direction
enum<string>

Sort order for A/B tests by start date. Use 'asc' for ascending or 'desc' for descending. Active A/B tests are always listed first.

Available options:
asc,
desc
Example:

"desc"

Response

OK

​
abtests
object[] | null
required

A/B tests.

​
count
integer
required

Number of A/B tests.

Example:

10

​
total
integer
required

Number of retrievable A/B tests.

Example:

12

⌘I