Build custom results experiences
Use our API to fetch quiz results and build completely custom results pages. Perfect for headless stores and advanced use cases.
{
"quiz_id": "shade-finder",
"customer": {
"email": "jane@example.com",
"answers": {
"skin_type": "combination",
"undertone": "warm",
"coverage": "medium"
}
},
"recommendations": [
{
"product_id": "gid://shopify/...",
"variant_id": "gid://shopify/...",
"title": "Miracle Balm",
"variant": "Shade 4 - Medium",
"score": 0.95,
"reason": "Perfect for warm undertones"
}
]
}API capabilities
Everything you need to build custom quiz experiences.
Results Endpoint
Fetch complete quiz results including product recommendations, scores, and customer data.
Webhooks
Real-time notifications when quizzes are completed. Push data anywhere.
Authentication
Secure API keys with scoped permissions. OAuth 2.0 support.
Full Documentation
Complete API reference with examples in multiple languages.
Sandbox Mode
Test your integration without affecting production data.
Rate Limits
Generous rate limits for high-traffic stores. Enterprise options available.
What you can build
Custom Results Pages
Build results pages that match your brand perfectly. Use React, Vue, or any framework.
Headless Commerce
Perfect for Hydrogen, Next.js, or any headless Shopify setup.
Mobile Apps
Embed quiz experiences in your iOS or Android app.
Email Personalization
Use quiz data to personalize post-purchase emails with product recommendations.
Ready to build?
Get API access and start building custom quiz experiences.