Introduction

Kibbe.ai turns product images, catalogs and body types into structured fashion data — delivered as a REST API with typed SDKs.

What you can build

Every item you send is described with one consistent attribute schema — category, silhouette, fabric, color, pattern, occasion — plus body-type fit across all 13 Kibbe image IDs. Use it to power search, recommendations, catalog enrichment and shopping agents.

QuickstartTag your first product image in under three minutes.AuthenticationBearer keys, scoped per environment.Attribute schemaEvery field the API can return, and what it means.Kibbe image IDsHow body-type fit is modelled and scored.

Base URL

All requests go to a single host. The environment is decided by your key, not the URL.

bash

https://api.kibbe.ai/v1

Sandbox keys run against a frozen catalog of 10,000 sample products so responses stay stable while you build. Swap to a live key when you ship — nothing else changes.

Response format

Responses are JSON. Lists are wrapped in an envelope with object: "list", a data array and a cursor for the next page. Timestamps are ISO 8601 in UTC. Confidence scores are decimals between 0 and 1.

json

{
  "object": "list",
  "data": [ /* … */ ],
  "next_cursor": "eyJpZCI6Iml0bV84ZjRjMmExYiJ9",
  "has_more": true
}