Skip to main content
GET
/
experiments
/
api
List experiments
curl --request GET \
  --url https://api.pictify.io/experiments/api \
  --header 'Authorization: Bearer <token>'
{
  "experiments": [
    {
      "uid": "exp_abc123",
      "slug": "homepage-hero-test",
      "type": "ab_test",
      "name": "Homepage Hero A/B Test",
      "status": "draft",
      "variants": [
        {
          "id": "variant-a",
          "weight": 5000,
          "name": "New Design",
          "templateUid": "<string>",
          "variables": {},
          "isDefault": false,
          "conditions": {
            "type": "group",
            "operator": "AND",
            "children": "<array>",
            "property": "<string>",
            "ruleOperator": "equals",
            "value": "<unknown>"
          },
          "schedule": {
            "startAt": "2023-11-07T05:31:56Z",
            "endAt": "2023-11-07T05:31:56Z",
            "recurrence": {
              "type": "none",
              "cronExpression": "<string>",
              "timezone": "America/New_York"
            }
          },
          "impressions": 123,
          "clicks": 123
        }
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "templateUid": "tmpl_xyz789",
      "goalConfig": {
        "type": "impressions_only",
        "destinationUrl": "<string>"
      },
      "banditConfig": {
        "enabled": false,
        "algorithm": "thompson_sampling",
        "warmupImpressions": 50,
        "recomputeIntervalMinutes": 15
      },
      "hypothesis": "<string>",
      "minimumSampleSize": 1000,
      "confidenceThreshold": 0.95,
      "minimumRunDays": 7,
      "winnerVariantId": "<string>",
      "winnerDeclaredAt": "2023-11-07T05:31:56Z",
      "fallbackImageUrl": "<string>",
      "outputConfig": {
        "format": "png",
        "quality": 90
      }
    }
  ],
  "total": 123,
  "page": 123,
  "limit": 123
}

Authorizations

Authorization
string
header
required

API key obtained from the Pictify dashboard

Query Parameters

type
enum<string>

Filter by experiment type

Available options:
ab_test,
smart_link,
scheduled
status
enum<string>

Filter by status

Available options:
draft,
running,
paused,
completed
page
integer
default:1

Page number

Required range: x >= 1
limit
integer
default:20

Number of results per page

Required range: 1 <= x <= 100

Response

List of experiments

experiments
object[]
total
integer

Total number of experiments matching filters

page
integer
limit
integer