Skip to main content
Developer Hub

One API. Every visual surface.

Visual search, room intelligence, 3D viewers, and catalogue enrichment — all behind a single REST API. Most teams ship in under two weeks.

< 500ms

Median API latency

200+

Edge locations

REST API

Direct HTTP · OpenAPI examples

OAS 3.1

OpenAPI spec available

Quickstart

Ship in three steps.

01

Get your API key

Create your workspace, generate an API key, and connect your first visual commerce flow.

Read quickstart
02

Ingest your catalogue

POST your product feed (SKU, image URL, attributes). Youzu indexes and embeds it in minutes.

Catalogue docs
03

Call the API

One REST call returns matches, placements, or renders. Drop our React widget or use raw JSON.

API reference
Code example

Visual search in one call.

Send an image URL to /v1/lens/search and get back ranked matches from your catalogue — with similarity scores and bounding boxes.

Base URLhttps://platform.youzu.ai
AuthBearer token (POST /v1/auth/token)
FormatJSON · OpenAPI 3.1 spec available
# 1. Get an access token
curl -X POST https://platform.youzu.ai/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{"api_key": "yz_live_••••••••"}'

# 2. Visual search with Youzu Lens
curl -X POST https://platform.youzu.ai/v1/lens/search \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://cdn.shop/sofa.jpg",
    "limit": 10,
    "threshold": 0.82
  }'
API surface

A calmer way to build visual commerce.

The developer experience should feel as considered as the shopper experience: quiet, clear, and fast to move through.

Layered API surface graphic
Documentation

Everything you need.

Ready to integrate?

Most teams ship Youzu Discover in two weeks and see ROI in the first month.

Get started

Ready to transform how your customers shop?

Most teams ship Youzu Discover in two weeks and see ROI in the first month. Book a 30-minute walkthrough on your own catalog.

No credit card. We'll reply within one business day.

We use cookies to improve your experience. Cookie policy