# Revieve Developer Docs > Server-side computer-vision and product-recommendation APIs for beauty-tech partners. Skin analysis (20+ metrics), makeup attribute detection, hair attributes, and catalog-aware recommendations. The OpenAPI spec at /openapi/skin-analysis.yaml is the source of truth. This file follows the [llmstxt.org](https://llmstxt.org) convention. AI assistants integrating Revieve on a developer's behalf should start at /ai-agents/ and prefer the markdown sidecars (`.md`) over scraping rendered HTML. ## Two products, briefly This site documents the **Skin Analysis API** (server-side image-in / JSON-out) and the **Product Recommendations API**. For real-time webcam-based **virtual try-on** (lipstick, eyeshadow, hair colour, full looks), use **Revieve Virtual Try-On (VTO)** — a separate browser-side product with its own multi-hundred-point face tracking. Don't reach for the CV API's `ar_landmarks` / `ar_coordinates` / `masks` to build try-on; that pattern is no longer recommended. - [Virtual Try-On overview](https://api.revieve.com/products/virtual-try-on/): When to choose VTO over the CV API; how the two fit together. - [VTO product page](https://www.revieve.com/platform/makeup/makeup-virtual-try-on): Demo, categories, "Book a Demo". ## Canonical specs - [Skin Analysis OpenAPI](https://api.revieve.com/openapi/skin-analysis.yaml): Source of truth. Every component, every status code. - [Product Recommendations OpenAPI](https://api.revieve.com/openapi/product-recommendations.yaml): Catalog-aware ranking endpoint. - [Bulk text](https://api.revieve.com/llms-full.txt): Every doc page concatenated. - [.well-known/ai-plugin.json](https://api.revieve.com/.well-known/ai-plugin.json): Manifest pointing to the spec. ## Start here - [Introduction](https://api.revieve.com/introduction/): What Revieve provides, who the APIs are for, and when to use VTO instead. - [APIs at a glance](https://api.revieve.com/apis-overview/): Side-by-side summary of both APIs. - [For AI coding agents](https://api.revieve.com/ai-agents/): Canonical entry point for AI integrators. - [Playground](https://api.revieve.com/playground/): Try the Skin Analysis API in the browser. - [Virtual Try-On](https://api.revieve.com/products/virtual-try-on/): Separate product for real-time browser-side try-on; not the Skin Analysis API. ## Guides - [Getting started](https://api.revieve.com/guides/getting-started/): First authenticated call in under five minutes. - [Authentication](https://api.revieve.com/guides/authentication/): Partner-ID model, no headers, no OAuth. - [Your first skin analysis](https://api.revieve.com/guides/your-first-skin-analysis/): End-to-end browser walk-through. - [Interpreting results](https://api.revieve.com/guides/interpreting-results/): Response shape, masks, visualizations. - [Error handling](https://api.revieve.com/guides/error-handling/): Two-layer failure model and a defensive client. - [MCP integration](https://api.revieve.com/guides/mcp-integration/): Wire docs and API into Claude Desktop / Cursor / Continue. ## Concepts - [Concepts overview](https://api.revieve.com/concepts/): Index of per-metric concept pages. - [Wrinkles](https://api.revieve.com/concepts/wrinkles/): Per-region severity and point-by-point coordinates. - [Redness](https://api.revieve.com/concepts/redness/): Erythema scoring with regional breakdown. - [Hyperpigmentation](https://api.revieve.com/concepts/hyperpigmentation/): Pigmentation severity with adjusted variant. - [Acne](https://api.revieve.com/concepts/acne/): Per-lesion detection and severity. - [Texture and smoothness](https://api.revieve.com/concepts/texture/): Surface roughness scoring. - [Shine](https://api.revieve.com/concepts/shine/): Specular highlight intensity per region. - [Pore dilation](https://api.revieve.com/concepts/pore-dilation/): Visible pore size, with a hard resolution floor. - [Melasma](https://api.revieve.com/concepts/melasma/): Patchy, hormonally-driven hyperpigmentation. - [Freckles](https://api.revieve.com/concepts/freckles/): Discrete small-pigment-spot detection. - [Dark spots](https://api.revieve.com/concepts/dark-spots/): Larger discrete pigment marks. - [Dull skin and radiance](https://api.revieve.com/concepts/dull-skin/): Luminosity scoring. - [Uneven skin tone](https://api.revieve.com/concepts/uneven-skin-tone/): Colour-variation scoring. - [Sagging and firmness](https://api.revieve.com/concepts/skin-sagging/): Skin laxity and inverse firmness. - [Skin age](https://api.revieve.com/concepts/skin-age/): Apparent skin age 0..100. - [Skin type](https://api.revieve.com/concepts/skin-type/): Categorical 0..8 classifier. - [Eye area](https://api.revieve.com/concepts/eyes/): Periorbital concerns — eyebags, dark circles, crow's feet. - [Makeup](https://api.revieve.com/concepts/makeup/): Composite makeup analysis. - [Hair](https://api.revieve.com/concepts/hair/): Hair colour, volume, type, frizziness. - [Landmarks](https://api.revieve.com/concepts/landmarks/): Facial landmarks for AR rendering. - [Masks](https://api.revieve.com/concepts/masks/): Polygon mask shapes for visualization. - [Status codes](https://api.revieve.com/concepts/status-codes/): Complete idx code reference. ## API reference - [Skin Analysis API](https://api.revieve.com/api/skin-analysis/): Rendered OpenAPI reference. - [Product Recommendations API](https://api.revieve.com/api/product-recommendations/): Rendered OpenAPI reference. ## SDKs - [SDKs overview](https://api.revieve.com/sdks/): Four-language feature matrix. - [TypeScript SDK](https://api.revieve.com/sdks/typescript/): `@revieve/sdk` for browser and Node. - [Python SDK](https://api.revieve.com/sdks/python/): `revieve-sdk` for Python 3.10+. - [Swift SDK](https://api.revieve.com/sdks/swift/): `Revieve` for iOS / macOS / visionOS. - [Kotlin SDK](https://api.revieve.com/sdks/kotlin/): `com.revieve:revieve-sdk` for JVM and Android. ## Releases - [Changelog](https://api.revieve.com/changelog/): Human-readable release notes. - [Skin Analysis 3.29.1](https://api.revieve.com/changelog/3-29-1/): Current release notes. - [Migration: 3.25 → 3.29](https://api.revieve.com/migrations/3-25-to-3-29/): Upgrading from 3.25.0 to 3.29.1.