PercelX Developer Platform
Integrate the PercelX Behavioral Intelligence API into your coaching platform, sports org, school, or enterprise product. Assessment scores, domain analysis, and Uri insights — all via REST.
# 1. Authenticate every request with your API key curl -X POST https://api.percelx.org/api/v1/assess \ -H "Authorization: Bearer pxk_live_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "userId": "usr_abc123", "domain": "athletic", "variables": { "fear_of_failure": 8, "self_discipline": 5, "identity_clarity": 6 } }' # Response (200 OK) { "success": true, "profile": { "sphereScore": 68, "tier": "Growth Zone" }, "topLimitations": ["fear_of_failure", "identity_clarity"], "mitPlan": { "phase1": "Identity Rebuild", "duration": "21 days" } }
API Products
Purpose-built API surfaces for behavioral assessment and real-time behavioral search.
Submit behavioral variables for any individual and receive a complete ecological profile — sphere scores, MIT transformation plan, pattern detection, 90-day roadmap, and root limitations ranked by impact.
Submit a behavioral query and receive sphere impact scores, root cause insight, LLM-driven transformation narrative, and follow-up guidance — all grounded in PercelX's behavioral pattern library.
API Reference
Assessment Request
{
"userId": "usr_abc123",
"domain": "athletic",
"variables": {
"fear_of_failure": 8,
"self_discipline": 5,
"identity_clarity": 6,
"coachability": 7,
"resilience": 4
}
}
Assessment Response
{
"success": true,
"profile": {
"sphereScore": 68,
"tier": "Growth Zone",
"domain": "athletic"
},
"topLimitations": [
"fear_of_failure",
"resilience"
],
"mitPlan": {
"phase1": "Identity Rebuild",
"duration": "21 days",
"actions": [...]
},
"requestId": "req_7xk2..."
}
Uri Search Request
{
"query": "I freeze under pressure
and lose focus in big games",
"domain": "athletic",
"userId": "usr_abc123"
}
Uri Search Response
{
"success": true,
"insight": {
"rootPattern": "fear_of_failure",
"sphereImpact": {
"mental": -32,
"athletic": -28
},
"narrative": "The freeze
response is a protection
mechanism..."
},
"transformation": { ... }
}
# Live key (requires active subscription) Authorization: Bearer pxk_live_a3f7... # Test key (always free, sandbox responses) Authorization: Bearer pxk_test_9d2b... # Error response when key is invalid or rate-limited { "error": "UNAUTHORIZED" } { "error": "RATE_LIMIT_EXCEEDED", "retryAfter": 60 }
Pricing
Start free with test keys. Scale to live keys when you're ready. No contracts, cancel anytime.
Starter
For indie builders and solo coaches testing integrations.
Growth
For growing products that need more volume and follow-up intelligence.
Professional
For teams building org-level intelligence products with batch capability.
Enterprise
For scaled platforms requiring SLAs, white-label, and dedicated infra.
All plans include free test keys. No setup fees. Billed monthly via Stripe. Cancel anytime from your developer dashboard.
Quickstart
Sign up with your email. A test API key is generated automatically and revealed once — save it immediately.
Use your pxk_test_... key immediately. Test keys are free, rate-limited to 100/day, and return real sandbox responses.
Choose Starter, Growth, or Professional from your developer dashboard. Stripe checkout — live key unlocked instantly after payment.
Track requests today, this minute, and total across all your keys. Manage keys, revoke, create new, and adjust allowed domains.
Use Cases
Give athletes real behavioral scores alongside physical metrics. Coaches get visibility into mental barriers affecting on-field performance.
Embed behavioral profiling into student-athlete development pipelines. Track transformation over an entire season.
Add structured behavioral intelligence to your coaching methodology. Replace gut-feel with data-driven domain profiles and MIT plans.
Surface organizational behavioral patterns across teams and departments using /org API and batch assessment for large-scale analysis.
Integrate Uri's natural language behavioral search to power conversational intelligence features that go beyond generic journaling.
Add a behavioral intelligence layer to any existing app using our lightweight REST endpoints — no ML infrastructure required.
Infrastructure
Keys are hashed at rest (bcrypt). Raw key revealed once. Revoke anytime.
EC2 + S3 + CloudFront. PM2 process management. Zero-downtime deploys.
All billing via Stripe. PCI compliant. Webhooks for instant plan sync.
Per-day and per-minute limits enforced in MongoDB. Fair usage guaranteed.
FAQ
/assess/batch count as one request regardless of how many records are submitted.pxk_test_...) are free, always available, rate-limited to 100 requests/day and 10/minute, and return real sandbox responses. Live keys (pxk_live_...) require an active subscription, use your full plan quota, and are suitable for production usage.userId field per request to associate assessments with your users. All requests are billed under your plan quota. For org-level features, see the /org endpoint available on Professional+.GET /api/v1/plan/domains for the full list. Each domain has its own variable set — call GET /api/v1/variables to see them all.429 RATE_LIMIT_EXCEEDED response. You are never charged for over-limit requests. Upgrade your plan to increase limits — changes take effect immediately.pxk_test_ key with 100 requests/day. No credit card required. Subscribe when you're ready to go live.