AI Skin Analysis API & Embeddable Skin Scanner
Integrate ScanSkinAI
Integrate facial skin analysis, skin-condition screening, product recommendations and AI skin scanning into your app, website or platform.
Insurer or employer instead? See ScanSkinAI Business Solutions →
Choose the product you need
Each API is a distinct product. Use the embed options when you do not need a custom integration.
Facial Skin Analysis API
Twelve cosmetic skin metrics, visual reports and guidance.
Explore product →Skin Condition Screening API
Condition classification, confidence and triage support.
Explore product →Product Recommendation API
Match analysed concerns to your own product catalogue.
Explore product →Embeddable scanner
Widget or hosted scan page without exposing an API key.
Explore product →Compare separate product subscriptions on the AI Skin Analysis API Pricing page.
Two very different integrations. Pick what fits.
The Embeddable Widget v3 and Hosted Scan Page embed let clinics add skin analysis to any website in minutes — no API key in the browser. The REST API is for teams building their own custom product, UI/UX, and workflows around the AI.
Embeddable Widget v3 or Hosted Scan Page
The fastest path to production. Drop a skin-condition widget or a hosted facial-scan page onto any site with one or two lines of HTML — no backend required.
- Skin condition checks — public widget ID, no API key in the browser
- Facial scans — embed your hosted ScanSkinAI page with one script tag
- Works on WordPress, Squarespace, Wix, Shopify, Webflow, plain HTML
- Managed setup via the Ivy AI admin portal
REST API
Maximum flexibility. Direct access to our clinical inference engine via secured JSON endpoints, webhooks and SSO — you own the UI and workflow.
- Days to weeks — you design the UI/UX
- Multi-lesion detection, triage, webhooks
- SSO / OAuth2 + full data-residency control
- Best for telehealth, clinic platforms, insurers
Two embed options, one snippet each
For general skin condition checks, drop in the ScanSkinAI Widget v3. For facial skin analysis, embed your hosted ScanSkinAI scan page directly on the client's site. Both are plug-and-play — no backend, no build tools.
Skin condition widget — add once to your page
<script src="https://www.scanskinai.com/widget/v3/scanskinai-widget.js"></script> <scanskinai-widget widget-id="YOUR_WIDGET_ID"></scanskinai-widget>
No API key in the browser. The widget ID is domain-locked and configured in the Ivy AI admin portal.
Facial scan — embed the hosted scan page
For beauty brands, salons and skincare stores, embed the hosted facial scan page so customers analyse 12 facial metrics and get routine recommendations without leaving your site. Replace YOUR_SLUG with the clinic's hosted page slug.
<div id="scanskinai-scan"></div> <script src="https://www.scanskinai.com/embed/v1/hosted-scan.js" data-slug="YOUR_SLUG" async></script>
See the skin condition widget live
Click any state to preview the full user journey, from upload to AI result.
For informational purposes only. Not a medical diagnosis. Always consult a qualified dermatologist.
Upload / idle — awaiting photo
Zero dependencies
Pure Web Component or iframe, isolated from your site's CSS and JS — no conflicts.
Works everywhere
WordPress, Webflow, Shopify, Wix, Squarespace, React, or plain HTML — all supported.
Choice-based inputs
Body location, duration, symptoms and progression — pre-built dropdowns, no typing required.
Dark mode built-in
Automatically follows your visitor's device preference.
Multi-language
English, Chinese (ZH) and Spanish (ES) out of the box.
Fully accessible
ARIA roles, keyboard navigation and screen reader support.
Brand-flexible
Custom accent colour, logo, and optional white-label mode.
Domain-locked widgets
No API key reaches the browser; widgets only work on registered domains.
Privacy-first
ScanSkinAI does not store uploaded images or scan results.
Getting started in 3 steps
Request your embed
Email info@scanskinai.com with your scan type (skin condition or facial), website domain, and whether you need a free or paid widget.
We configure it
Ivy AI staff build your widget v3 or hosted scan page in the admin portal, set your domain lock, branding and payment mode, then send you the exact snippet.
Paste & publish
Paste the snippet into your website's HTML block and publish. No build step required.
Build your own product on top of the ScanSkinAI API
For teams that need full control of the UI/UX, data flow and clinical workflow. Returns structured lesion classification, probability, multi-lesion detection and clinical triage. Requires backend and frontend development.
Built for the organisations powering modern skin health
Six customer segments, one unified ScanSkinAI platform.
Health & Beauty Apps
Consumer skincare, wellness and beauty apps embedding AI skin analysis into their own experience.
Telemedicine Platforms
Virtual care and online dermatology services automating triage and pre-consult assessments.
Skin Product Websites
DTC skincare brands and marketplaces personalising recommendations with data-driven matching.
Healthcare Providers & Workers
Clinics, GPs, dermatology specialists and researchers integrating AI into EHR / EMR workflows.
Laboratory Service Providers
Diagnostic labs and research groups using AI skin data to enrich testing and reporting pipelines.
Online Pharmacies
Pharmacies and pharma retailers closing the loop from skin scan to prescription and product sale.
One REST API, three industries served
One ScanSkinAI skin lesion analysis API — used across consumer apps, clinics and product ecosystems.
Connect with your customers
Call the ScanSkinAI REST API from your app to deliver clinically informed skin lesion analysis, personalised follow-ups and health guides — all under your brand.
Send an image, receive structured JSON in seconds. The API returns lesion classification, confidence and a risk score straight back to your app — every interaction stays inside your own experience.
Telemedicine ready
Automate your online dermatology consultations with AI-powered triage and structured pre-consult reports your clinicians can sign off in seconds.
REST API integration
One HTTPS endpoint — works with any backend or mobile stack.
Personalised follow-ups
Use structured results to drive re-scan reminders and content.
Health & education content
Deliver tailored skin guides that drive engagement and retention.
Telemedicine automation
Pre-screen patients before video consults to save clinician time.
How integration works
Integration is REST API only — no SDKs to install, no EHR connectors required. Works with any backend: Node, Python, PHP, Ruby, Go or .NET.
Apply for Sandbox
Sign up at ivyai.hk to instantly receive sandbox API credentials — no sales call required.
Build & Test
Call our REST endpoints with your sandbox key. Full request / response samples, no rate caps for development.
Go Live
Submit a short production review (~24h). Receive your production key and start serving real users.
One endpoint. Comprehensive lesion analysis.
Every call returns clinic-validated structured data — classification, confidence, probability and triage in one response.
Lesion Classification
Identify moles, skin tags, rashes and suspicious lesions with a primary class label.
Confidence Scores
Model confidence for the predicted class so you can set your own review thresholds.
Probability (0–100)
Probability the lesion matches the predicted condition — drive in-app prioritisation and follow-ups.
Clinical Triage
Four-level triage recommendation: self-monitor, GP visit, dermatologist, urgent.
Differential Diagnosis
Top alternative conditions returned with each call to support clinical review.
Multi-language Output
Recommendations available in EN, ZH, JA, KO, ES, FR, DE and more.
Multi-Lesion Detection
Detect, locate and classify every lesion in a single full-body or regional photo — one API call returns all bounding boxes.
Your first scan in one HTTP request
Any HTTP client works — no SDK required. Below are copy-paste examples in cURL, Node.js and Python, plus a real sample JSON response.
cURL
curl https://api.scanskinai.com/v1/scans \ -H "Authorization: Bearer $SCANSKINAI_KEY" \ -H "Content-Type: multipart/form-data" \ -F "image=@mole.jpg" \ -F "body_location=back" \ -F "language=en"
Node.js (fetch)
const form = new FormData();
form.append("image", fs.createReadStream("mole.jpg"));
form.append("body_location", "back");
const res = await fetch("https://api.scanskinai.com/v1/scans", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SCANSKINAI_KEY}` },
body: form,
});
const data = await res.json();Python (requests)
import os, requests
r = requests.post(
"https://api.scanskinai.com/v1/scans",
headers={"Authorization": f"Bearer {os.environ['SCANSKINAI_KEY']}"},
files={"image": open("mole.jpg", "rb")},
data={"body_location": "back", "language": "en"},
)
data = r.json()Sample response (HTTP 200)
{
"request_id": "scn_01HK9V…",
"model_version": "skin-v4.2",
"primary": {
"class": "melanocytic_nevus",
"label": "Benign mole",
"confidence": 0.94,
"probability": 0.91
},
"differential": [
{ "class": "seborrheic_keratosis", "confidence": 0.04 },
{ "class": "melanoma", "confidence": 0.02 }
],
"triage": {
"level": "self_monitor",
"recommendation": "Re-scan in 3 months. See a GP sooner if the mole changes.",
"language": "en"
},
"quality": { "focus": "ok", "lighting": "ok", "is_skin": true },
"latency_ms": 1832
}Full reference — endpoints, error codes, webhooks and Postman collection — ships with your sandbox credentials.
Fast, predictable monthly plans
Transparent rate limits, sub-2-second median latency and monthly call plans that scale with your volume.
< 2s median latency
Single-lesion classification from EU / UK regions. 4–8s for multi-lesion full-body scans.
99.9% uptime SLA
Enterprise contracts include credit-back terms and prioritised routing.
120 req/min production
Sandbox 60 rpm. Burst up to 300 rpm for 10s. Enterprise keys get custom limits.
Plans from $99 / month
Free 50-call sandbox, then Starter / Growth / Scale monthly plans. Enterprise custom.
Multi-Lesion Detection API
Detect, locate and classify every lesion in a single full-body or regional photo — one API call returns per-lesion bounding boxes, predicted condition, confidence and quality flags.
What every response includes
- Per-lesion bounding box coordinates (x, y, w, h)
- Predicted class: melanoma, nevus, BCC, seborrheic keratosis, normal skin, and more
- Confidence score per lesion (0–100%)
- Stable lesion ID for longitudinal tracking across follow-up scans
- Quality flags: "too small", "not a skin image", out-of-focus
Ideal for
Teledermatology triage · Full-body mole mapping platforms · Clinical research cohorts · Insurer and employer screening programmes.
Interested in early access?
Currently in private beta — pricing and rate limits provided on request.
Security & compliance
Built for regulated industries. Audit-ready out of the box.
Frequently asked questions
Pricing, latency, rate limits, data retention and compliance — the answers engineering and procurement teams ask most.
The REST API sandbox is a free, non-expiring test environment with 50 one-time calls. Production API access is purchased separately for each API product on a tiered monthly volume model. The Widget v3 and hosted scan page embed are configured per clinic as free or paid; paid setups use your own Stripe, Square or PayPal checkout, with no separate ScanSkinAI transaction fee beyond the underlying scan credits. Email info@scanskinai.com for a written quote.
Median end-to-end latency for a single-lesion classification call is under 2 seconds from EU and UK regions, and typically 3–4 seconds globally. Multi-lesion full-body detection returns in 4–8 seconds depending on image resolution and lesion count. Enterprise contracts include a 99.9% monthly uptime SLA with credit-back terms, prioritised routing and a status page subscription.
The API accepts JPEG, PNG, HEIC and WebP up to 20 MB per image. Recommended minimum is 1024×1024 for single-lesion scans and 2048×1536 for multi-lesion full-body scans. Images are auto-oriented from EXIF, resized server-side and quality-flagged — if a photo is out of focus, too dark, or not a skin image, the API returns a structured quality error instead of a low-confidence prediction.
For the skin-condition REST API, the default process-and-discard mode does not persist uploaded images; request metadata is retained for 30 days for debugging and rate-limit enforcement, then purged. Facial API photos follow that product's stated UK-processing and deletion policy. Hosted pages, widgets and clinician-review services have separate retention terms because they can create customer records. Enterprise retention and regional hosting are set in the DPA.
ScanSkinAI operates under ISO 27001:2022 information-security management and UKCA Class I medical-device registration. The service is GDPR-aligned by default; HIPAA-ready deployments are available with a signed BAA for US customers. All traffic is TLS 1.2+ and API keys are bearer tokens scoped to a single environment. Widget v3 uses a public widget ID and domain lock — the upstream API key is never exposed in the browser.
The free REST API sandbox includes 50 one-time calls and is rate-limited to 60 requests/minute while allowance remains. Production is 120 requests/minute per key by default, with burst allowance up to 300/minute for 10 seconds. Enterprise keys use custom limits. Widget v3 limits are configured separately from API plans.
The REST endpoints are language-agnostic — any HTTP client works. We publish tested code samples in cURL, Node.js (fetch/axios), Python (requests), PHP, Ruby, Go and .NET. No official SDK is required; a lightweight TypeScript helper is available on request. Widget v3 and hosted scan pages support EN, ZH and ES out of the box, with more languages available on request.
Server-to-server is the recommended pattern for the REST API — your backend proxies the request so the API key stays private. For browser-only use cases, use the Widget v3 (domain-locked, no exposed key) or the hosted scan page embed. For native iOS or Android apps, embed the call in your own backend or use a short-lived signed URL provisioned by your server; never ship a production API key inside a mobile binary.
Widget IDs and hosted scan page slugs are provisioned by Ivy AI staff in the admin portal. Email info@scanskinai.com with your company name, website domain, scan type (skin condition or facial), and whether you want a free or paid widget. We will create the configuration, send you the snippet, and activate the domain lock.
Headquartered in the heart of Canary Wharf
ScanSkinAI is built by Ivy AI Solutions Limited, a London-based health-tech startup headquartered at One Canada Square in Canary Wharf. We design our workplace skin cancer screening platform for UK small businesses, with UKCA Class I registration and ISO 27001 information security.
From our London HQ we support partners across the United Kingdom, Hong Kong, Singapore and the Asia-Pacific region — with clinical validation, enterprise security and dedicated integration support.
Start building today
Request an embed setup for your site, or apply at ivyai.hk and receive your sandbox API key instantly. Production access is reviewed within ~24 hours.
Sandbox is free. Production access after review (~24h).
See API pricing · Not a developer? See Brand solutions or Spa solutions.