Back to Home
Norman AI Documentation
Welcome to the comprehensive documentation for Norman AI, the automated UX testing platform that revolutionizes how you test and improve your user experiences.
Introduction
Norman AI is an AI-powered UX testing platform that automates the entire user testing process. From test creation to participant recruitment, video recording, and insight generation, Norman AI handles everything so you can focus on building better products.
🎯 What Makes Norman AI Different
- AI-Assisted Test Creation: Our AI helps you create comprehensive test scenarios tailored to your product
- 6M+ Global Participant Pool: Access to a diverse, qualified user base worldwide
- Automated Analysis: Get instant insights and recommendations from test results
- Affordable Pricing: Accessible plans for startups to enterprise
Quick Start
Get up and running with Norman AI in just a few minutes:
Step 1: Create Your Account
Sign up for a free trial at app.user500.com/signup-free
Step 2: Set Up Your First Test
- Log into your Norman AI dashboard
- Click "Create New Test"
- Describe your product and testing goals
- Let our AI generate test scenarios
- Review and customize the test questions
Step 3: Launch and Get Results
- Define your target participant criteria
- Launch the test
- Our platform automatically recruits participants
- Receive comprehensive reports within 24-48 hours
AI Test Creation
Our AI-powered test creation feature helps you design comprehensive, effective user tests without the guesswork.
How It Works
Product Analysis
Upload your design or describe your product. Our AI analyzes the interface and identifies key testing areas.
Scenario Generation
AI creates realistic user scenarios based on your product type and target audience.
Question Optimization
Generate unbiased, effective questions that elicit meaningful user feedback.
Best Practices for AI Test Creation
- Be Specific: Provide detailed information about your product and goals
- Define Success Metrics: Tell the AI what you want to measure
- Review and Refine: Always review AI-generated content and customize as needed
- Test Different Scenarios: Create multiple test variations for comprehensive insights
Participant Recruitment
Access our global network of 6+ million qualified participants across diverse demographics and industries.
Targeting Options
- Demographics: Age, gender, location, income level
- Behavioral: Technology usage, shopping habits, interests
- Professional: Industry, job role, company size
- Custom Criteria: Define specific requirements for your test
Recruitment Process
- Define your target participant profile
- Set participant count and budget
- Our platform automatically screens and recruits qualified users
- Participants complete your test within the specified timeframe
- Quality assurance ensures high-quality responses
Video Recordings
Capture every user interaction with high-quality video recordings and screen captures.
Recording Features
- Screen Recording: Full desktop or mobile screen capture
- Audio Recording: Clear participant voice and feedback
- Webcam Recording: See participant facial expressions and reactions
- Multi-Device Support: Desktop, tablet, and mobile recording
Video Quality Settings
// Video quality options
{
"quality": "high", // low, medium, high, ultra
"resolution": "1920x1080",
"frameRate": 30,
"audioQuality": "high"
}
Smart Transcripts
Get AI-generated transcripts of all user sessions with timestamps and key insights highlighted.
Transcript Features
- Automatic Transcription: Convert speech to text with high accuracy
- Timestamp Markers: Sync transcripts with video timestamps
- Sentiment Analysis: Identify positive, negative, and neutral feedback
- Key Phrase Extraction: Highlight important quotes and insights
Reports & Insights
Receive comprehensive reports with actionable insights and recommendations.
Report Components
Executive Summary
High-level overview of key findings and recommendations
User Journey Analysis
Detailed breakdown of user paths and pain points
Usability Metrics
Quantitative data on task completion rates and efficiency
Video Highlights
Curated video clips showing key moments and issues
API Authentication
Norman AI uses API keys for authentication. Include your API key in the Authorization header of all requests.
curl -H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
https://api.normanai.com/v1/tests
Getting Your API Key
- Log into your Norman AI dashboard
- Navigate to Settings > API Keys
- Click "Generate New Key"
- Copy and securely store your API key
⚠️ Security Note
Keep your API key secure and never expose it in client-side code. Use environment variables or secure key management systems.
Test Management API
Create, manage, and monitor your UX tests programmatically.
Create a Test
POST /v1/tests
{
"name": "Mobile App Onboarding Test",
"description": "Test the new user onboarding flow",
"scenarios": [
{
"title": "Complete Sign Up",
"description": "Create a new account and complete profile setup",
"tasks": [
"Navigate to sign up page",
"Fill out registration form",
"Verify email address",
"Complete profile setup"
]
}
],
"participantCriteria": {
"ageRange": [18, 35],
"location": ["US", "CA"],
"deviceTypes": ["mobile"],
"experienceLevel": "beginner"
},
"budget": 500,
"participantCount": 20
}
Get Test Results
GET /v1/tests/{test_id}/results
Figma Integration
Seamlessly integrate Norman AI with your Figma designs for instant user testing.
Installation
- Open Figma
- Go to Plugins > Browse all plugins
- Search for "Norman AI"
- Install the plugin
Usage
- Select your design frames in Figma
- Open the Norman AI plugin
- Configure your test parameters
- Launch the test directly from Figma
- View results in the Norman AI dashboard
Best Practices
Test Design
- Keep Tests Focused: Test one specific feature or flow at a time
- Realistic Scenarios: Use scenarios that reflect real user behavior
- Clear Instructions: Provide clear, unbiased task instructions
- Appropriate Length: Keep tests between 10-20 minutes for optimal engagement
Participant Selection
- Match Your Audience: Recruit participants who represent your target users
- Diverse Perspectives: Include participants from different backgrounds
- Appropriate Sample Size: Use 5-8 participants for qualitative insights, 20+ for quantitative data
Analysis and Action
- Focus on Patterns: Look for recurring issues across multiple participants
- Prioritize by Impact: Address issues that most affect user experience
- Iterate and Test Again: Continuously test improvements
Troubleshooting
Common Issues
Test Not Launching
- Check that all required fields are filled
- Verify participant criteria are realistic
- Ensure sufficient budget is allocated
Low Participant Response
- Broaden participant criteria
- Increase participant incentives
- Simplify test requirements
Video Quality Issues
- Check participant's internet connection
- Verify browser permissions for camera/microphone
- Try different browsers or devices
Frequently Asked Questions
General Questions
How long does it take to get test results?
Most tests are completed within 24-48 hours, depending on participant availability and test complexity.
Can I test mobile apps?
Yes! Norman AI supports testing on desktop, tablet, and mobile devices, including native mobile apps.
What's the minimum number of participants?
We recommend a minimum of 5 participants for qualitative insights, but you can test with as few as 1 participant.
Technical Questions
Do you provide an API?
Yes! Norman AI offers a comprehensive REST API for programmatic access to all features.
Can I integrate with my existing tools?
Absolutely! We offer integrations with Figma, Adobe Creative Suite, Retool, and custom API integrations.
How secure is my data?
We use enterprise-grade security with encryption in transit and at rest, SOC 2 compliance, and regular security audits.
🎉 Ready to Get Started?
Start your free trial today and experience the power of automated UX testing with Norman AI.
Start Free Trial