[ Agent API ]

Give your agents the power to optimize.

The Humblytics API lets AI agents analyze pages, generate A/B test hypotheses, and launch experiments — programmatically. No dashboard required.

Get API key
split-test-recommendations
GET /api/external/v1/properties/{id}
    /split-test-recommendations

{
  "recommendations": [{
    "title": "Hero CTA Text",
    "selector": "button.hero-cta",
    "confidence": 84,
    "variant": "Start Free Trial",
    "impact": "High: 8%+"
  }]
}

See what agents can do with Humblytics.

From recommendations to experiment deployment, the API powers agents that optimize your site autonomously.

Recommendations API

Your agent calls one endpoint and gets AI-powered test ideas — each with a CSS selector, confidence score, and estimated revenue impact.

humblytics — recommendations
$ GET /split-test-recommendations
  ?page=/pricing

 3 recommendations found

┌─ #1 Hero CTA Text ─────────────
  confidence: 84  impact: High +8%
  selector: button.hero-cta
  variant: "Start Free Trial"
└────────────────────────────

┌─ #2 Pricing Toggle ───────────
  confidence: 76  impact: Med +4%
└────────────────────────────

┌─ #3 Social Proof Position ────
  confidence: 71  impact: Med +3%
└────────────────────────────

Split Test API

Create no-code A/B tests with text changes, CSS modifications, or element swaps — all defined in JSON. Tests go live immediately.

humblytics — split-test
$ POST /split-tests

 Test created — running now

  name: Hero CTA A/B Test
  page: /pricing
  auto_stop: 14 days

  A "Get Started"      ████░░░░░░ 3.2%
  B "Start Free Trial"  ███████░░░ 5.1%

  visitors: 1,240
  status: running  confidence: 89%

Analytics API

Query visitors, conversions, top pages, and revenue data. Your agent reads your analytics to make data-driven decisions.

humblytics — analytics
$ GET /properties/analytics
  ?period=today

  visitors 2,841  ↑ 12%
  conversions 119    ↑ 8%
  conv. rate 4.2%   ↑ 0.8pp
  bounce 34%     ↓ 3%

  ── top pages ──────────────────
  /pricing        ████████████████ 842
  /features       ██████████░░░░░░ 531
  /               ████████░░░░░░░░ 428
  /blog           ██████░░░░░░░░░░ 312

Agent Onboarding

Sign up without leaving the terminal. Your agent initiates signup, the user verifies, and receives a ready-to-use API token.

claude-code — humblytics setup
$ POST /auth/agent-initiate
  { "email": "[email protected]" }

 Verification link sent
  → https://app.humblytics.com/verify/...

⏳ Waiting for user...
 Email verified
 Payment complete
 Property created

$ GET /auth/agent-signup-status

  authToken: eyJhbGci...kpXVCJ9
  status: ready

Agent onboarding

Sign up without leaving the terminal

Your agent initiates signup, sends the user a verification link, polls for completion, and receives a ready-to-use API token — all programmatically.

01

Initiate signup

Agent calls POST /api/v1/auth/agent-initiate with the user's email and name. Returns a unique verification URL and session token.

02

User verifies & pays

The user opens the link in their browser — identity verification, plan selection, and Stripe payment all happen in under a minute.

03

Receive the API token

The agent polls GET /api/v1/auth/agent-signup-status and receives a JWT auth token the moment the user finishes. From there, it can add websites and start calling the full API.

Full onboarding spec

Fetch the complete agent onboarding API reference — account creation, website setup, script installation, and analytics endpoints — in a single file:

terminal
curl -o HUMBLYTICS.md https://app.humblytics.com/agent.md

How it works

Two API calls.
Full automation.

Your agent reads your data, generates test ideas, and launches experiments — no human in the loop.

01

Get recommendations

Your agent calls GET /split-test-recommendations and receives AI-powered test ideas — each with a selector, confidence score, and suggested variant.

02

Launch the experiment

Pipe the selectors into POST /split-tests. The agent creates a no-code A/B test with text changes or CSS modifications — the test goes live immediately.

03

Agent manages the rest

Set auto_stop_days: 14 and the experiment runs to completion. The agent checks back for results, then launches the next test — a continuous optimization loop.

Anything you can optimize manually, your agent can too.

Automate what's tedious. Accelerate what's ambitious.

Autonomous CRO agent

Loop through high-traffic pages, pull recommendations, and deploy tests — all without opening a dashboard.

Post-deploy testing

Wire the API into your CI/CD pipeline. Every new landing page automatically gets a split test.

Conversion recovery

When your agent detects a conversion drop, it pulls recommendations and launches a recovery test.

Bulk optimization

Manage experiments across dozens of client properties programmatically. Agencies, this is for you.

Agent Skills

Pre-built skills that use the API

Open-source marketing and CRO skills your agent loads as context. Skills that connect to Humblytics use your own API key.

CRO OptimizerAPI
A/B Test GeneratorAPI
Page CRO
Funnel ReporterAPI
Marketing Strategist
Copywriting
Ad Expert
Content Strategist

Add to your agent's context

Load the full API spec directly into your editor:

terminal
curl -o HUMBLYTICS.md https://app.humblytics.com/agent.md

Get started

Connect your agent in 60 seconds

Add these instructions to your CLAUDE.md, .cursorrules, or system prompt — and your agent becomes a CRO team.

CLAUDE.md
## Humblytics A/B Testing API

### Setup
If the user doesn't have an account yet, fetch the full onboarding spec:
curl -o HUMBLYTICS.md https://app.humblytics.com/agent.md
Follow the steps to create an account, add a website, and get an API key — all without leaving the terminal.

API Base: https://app.humblytics.com/api/external/v1
Auth: Bearer $HUMBLYTICS_API_KEY

### Get Recommendations
GET /properties/{property_id}/split-test-recommendations?page={path}

### Create Split Test
POST /properties/{property_id}/split-tests
Body: { name, page, type: "nocode", goal, auto_stop_days,
  variants: [{ label, changes: [{ selector, op, value }] }] }

### Rules
- Always get recommendations first
- Only test recommendations with confidence >= 70
- Default auto_stop_days: 14
- goal: "click_through" for CTAs, "conversion" for forms
Get your API key
The agent web is here

Build for AI agents — or get left behind.

Your competitors are already making their sites agent-readable. Start with the API that lets agents optimize your conversions autonomously.