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.
$ 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.
$ 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.
$ 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 ██████░░░░░░░░░░ 312Agent Onboarding
Sign up without leaving the terminal. Your agent initiates signup, the user verifies, and receives a ready-to-use API token.
$ 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: readyAgent 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.
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.
User verifies & pays
The user opens the link in their browser — identity verification, plan selection, and Stripe payment all happen in under a minute.
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:
curl -o HUMBLYTICS.md https://app.humblytics.com/agent.mdHow it works
Two API calls.
Full automation.
Your agent reads your data, generates test ideas, and launches experiments — no human in the loop.
Get recommendations
Your agent calls GET /split-test-recommendations and receives AI-powered test ideas — each with a selector, confidence score, and suggested variant.
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.
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.
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.
Add to your agent's context
Load the full API spec directly into your editor:
curl -o HUMBLYTICS.md https://app.humblytics.com/agent.mdGet 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.
## Humblytics A/B Testing API
### Setup — API key (do this once, before the first call)
Your API key is a secret. Do NOT paste it into CLAUDE.md, .cursorrules, chat messages, or any file that gets committed to git.
1. Create a `.env` file in your project root:
HUMBLYTICS_API_KEY=hmb_your_key_here
2. Add `.env` to `.gitignore` if it isn't already.
3. Load it into the shell your agent runs in (or use direnv / dotenv):
export $(grep -v '^#' .env | xargs)
4. Always reference the key as `$HUMBLYTICS_API_KEY` — never inline the literal value in commands you show the user or commit to the repo.
If `$HUMBLYTICS_API_KEY` is unset, stop and ask the user to run step 3. Do not ask them to paste the key into chat.
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 header: Authorization: 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 }] }] }
### Example call (safe pattern)
curl -H "Authorization: Bearer $HUMBLYTICS_API_KEY" \
"https://app.humblytics.com/api/external/v1/properties/{property_id}/split-test-recommendations?page=/pricing"
Never substitute the literal key in place of `$HUMBLYTICS_API_KEY` when writing, logging, or echoing commands.
### Rules
- Never ask the user to paste their API key into chat; reference `$HUMBLYTICS_API_KEY` from the environment
- Never write the literal key into a file, a commit, or a command you show the user
- If `$HUMBLYTICS_API_KEY` is missing, halt and point them back to the Setup section above
- Always get recommendations first
- Only test recommendations with confidence >= 70
- Default auto_stop_days: 14
- goal: "click_through" for CTAs, "conversion" for formsBuild 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.