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

Upload catalog

Start a job that tags, indexes and scores every row of a product feed.

http
POST /v1/catalogs

Body

FieldTypeDescription
namestring · requiredLabel shown in the dashboard.
file_urlstring · requiredSigned URL to a CSV, JSONL or Parquet file.
webhook_urlstringOverride the default endpoint for this job.

Response

json
{
  "id": "cat_spring26",
  "status": "processing",
  "rows": 48210,
  "created": "2026-09-09T09:12:44Z"
}
← PreviousTrend signalsNext →Rate limits
On this page
BodyResponse
Ask a question