Kibbe.aiDocs
PlatformLearnAboutGet an API key
DocumentationAPI referenceSDKsChangelog
Endpoints›Search products
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/Search products

Search products

Find products by text, image or both, ranked across your catalogs.

http
POST /v1/search

Body

FieldTypeDescription
querystringNatural language, e.g. "linen shirt, relaxed fit".
image_urlstringSearch visually. Combine with query to refine.
filtersobjectAny schema attribute, plus kibbe_id and catalog_id.
limitinteger1–100. Default 25.

Example

bash
curl -X POST https://api.kibbe.ai/v1/search \
  -H "Authorization: Bearer kb_live_…" \
  -d '{ "query": "black satin slip dress", "filters": { "kibbe_id": "romantic" } }'
← PreviousTag an imageNext →Similar items
On this page
BodyExample
Ask a question