Kibbe.aiDocs
PlatformLearnAboutGet an API key
DocumentationAPI referenceSDKsChangelog
Endpoints›Tag an image
Getting started
  • Introduction
  • Quickstart
  • Authentication
  • Environments
Core concepts
  • Attribute schema
  • Kibbe image IDs
  • Catalogs
  • Webhooks
Endpoints
  • Tag an imagePOST
  • Search productsPOST
  • Similar itemsGET
  • Body-type fitGET
  • Trend signalsGET
  • Upload catalogPOST
Reference
  • Rate limits
  • Errors
  • SDKs
  • Changelog
Endpoints/Tag an image

Tag an image

Extract structured attributes and Kibbe fit from a single product image.

http
POST /v1/tag

Body

FieldTypeDescription
image_urlstring · requiredPublic URL of a product image. JPEG, PNG or WebP.
fieldsstring[]Limit the response to these attributes.
include_fitbooleanAdd kibbe_fit scores. Default true.

Example

bash
curl -X POST https://api.kibbe.ai/v1/tag \
  -H "Authorization: Bearer kb_live_…" \
  -d '{ "image_url": "https://cdn.shop/sku-4821.jpg" }'
json
{
  "id": "itm_8f4c2a1b",
  "category": "blazer",
  "silhouette": ["structured"],
  "fabric": ["wool blend"],
  "color": { "name": "navy", "hex": "#1F2A44" },
  "kibbe_fit": [ { "id": "dramatic_classic", "score": 0.91 } ]
}
← PreviousWebhooksNext →Search products
On this page
BodyExample
Ask a question