Docs & API
Add skin analysis to your website or app.
Use the API, embed the widget or connect an AI assistant through MCP. Choose the integration that fits your storefront, app or checkout.
REST API
Send a photo, get back a structured skin profile and ranked product matches. Built for deeper skin tones first, measured across Fitzpatrick I to VI.
Widget & SDK
Embed the scan flow on a product page or kiosk. Match it to your brand and use it on mobile without rebuilding your site.
MCP & agent tools
Connect your AI agents to Oyster tools. Pearl uses those tools on WhatsApp, in store and over voice.
A scan, in one request.
Send an image and receive the skin profile and product matches as JSON.
# request
POST /v1/analyze
{ "image": "https://cdn.store/selfie.jpg", "market": "ZA" }
# response
{
"skin": { "hydration": 0.42, "barrier": "compromised", "concerns": ["dark spots", "texture"] },
"matches": [ { "sku": "TIAM-VITB3", "confidence": 0.94 } ]
}
POST /v1/analyze
{ "image": "https://cdn.store/selfie.jpg", "market": "ZA" }
# response
{
"skin": { "hydration": 0.42, "barrier": "compromised", "concerns": ["dark spots", "texture"] },
"matches": [ { "sku": "TIAM-VITB3", "confidence": 0.94 } ]
}
Get help with your integration.
Get API keys, a test environment and help from our team. Most partners are live within two hours.