← API overviewAPI Product

Use My Own Inventory

Connect your own product catalog — Shopify, a custom database, any CRM — with a single sync call. Runway Edit and StyleMe run exactly the same way as the marketplace product, but every matched piece comes from your inventory instead of ZukMe's, and the finished look can be pushed straight back to you via webhook.

Go to API Dashboard →API Docs

Capabilities

What it does

Sync your inventory

Push your current product list — name, image, category, price, link — to one endpoint. No feed URL, no custom integration: works with any backend that can make an HTTP request.

Match & render

Submit a StyleMe reading and photo, exactly like the marketplace product — StyleMe matches the best piece from your synced inventory per garment category and puts it on your user.

Getting started

1. Sync your inventory

A full-replace sync — the products you send become your entire matchable catalog. Call it again any time your catalog changes; there's no partial update to track.

bash

curl https://zukme.com/api/v1/inventory/products \
  -X PUT \
  -H "Authorization: Bearer zk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "products": [
      {
        "id": "sku-001",
        "name": "Tailored Wool Blazer",
        "imageUrl": "https://cdn.yourstore.com/blazer.jpg",
        "price": "USD 220",
        "category": "outerwear",
        "link": "https://yourstore.com/products/tailored-wool-blazer"
      }
    ]
  }'

# response: { "ok": true, "count": 1 }

Getting started

2. Match & render

Get a StyleMe reading, then submit it to the inventory try-on endpoint along with the same photo. Add an optional callbackUrl to have the finished result pushed to you, in addition to polling.

bash

curl https://zukme.com/api/v1/inventory/tryon \
  -X POST \
  -H "Authorization: Bearer zk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "reading": { /* from POST /api/v1/styleme */ },
    "photoBase64": "<base64>",
    "occasion": "Client presentation",
    "callbackUrl": "https://yourapp.com/webhooks/zukme-tryon"
  }'

# response: { "ok": true, "jobId": "...", "status": "processing" }
# ...and once done, we POST the same result to callbackUrl:
# { "jobId": "...", "status": "done", "imageUrl": "https://...", "outfitBreakdown": [...] }

Reference

Endpoints

PUT /api/v1/inventory/productssync your inventory (full replace)

GET /api/v1/inventory/productsview your currently synced inventory

POST /api/v1/runway-editsubmit or poll a Runway Edit generation job

POST /api/v1/stylemesubmit or poll a StyleMe reading job

POST /api/v1/inventory/tryonsubmit or poll a match + render job against your inventory

Full field-by-field request/response schemas, error codes, and copy-paste examples are in the API Docs. Want to match against ZukMe's own marketplace instead? Pull from Marketplace — same account, same credits.