Skip to main content
GET
List experiments

Experiments

Create and manage experiments to test image variants. Supports A/B tests with Thompson Sampling, smart links with condition-based routing, and scheduled variants.
For experiment types, lifecycle, and tracking details, see Experiments Concept.

Endpoints

Editable Fields by Status

Variant weights must sum to exactly 10,000 (basis points). A 50/50 split uses weights of 5000 and 5000.

Experiment Status

Slug Requirements

Best Practices

  1. Use descriptive slugs that identify the test (e.g., email-banner-cta-test)
  2. Start with a 50/50 split before enabling auto-optimization
  3. Set clear goals — use click_through when you want to measure engagement
  4. Check your quota before creating experiments with GET /experiments/api/quota
  5. Always send a write key with event tracking to prevent data tampering

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