Identify Clothing

Analyze an outfit image to identify individual clothing items with descriptions, colors, style tags, and purchase links.

Endpoint

POST /identify_clothing

Request body

Field	Type	Required	Description
image_url	string	Yes	URL of the outfit image to analyze

Example request

curl -X POST https://mcll3bnfubyazfg6wekv3xc6fi0dgpyk.lambda-url.us-east-1.on.aws/identify_clothing \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://example.com/outfit.jpg"}'

Response

Field	Type	Description
items	array	List of identified clothing items

Item object

Field	Type	Description
item	string	Item name (e.g. “oversized blazer”)
description	string	Detailed description
color	string	Color name (e.g. “charcoal grey”)
style_tags	string[]	Style categories (e.g. [“minimalist”, “streetwear”])
category	string	Clothing category (e.g. “top”, “bottom”, “shoes”)
price_range	string	Estimated range: “budget”, “mid-range”, “premium”, or “luxury”
products	array	Purchase links found online

Product object

Field	Type	Description
title	string	Product listing title
url	string	Purchase URL
thumbnail	string	Product image URL
price	string	Listed price
store	string	Retailer name
snippet	string	Product description snippet

Example response

{
  "items": [
    {
      "item": "oversized blazer",
      "description": "Relaxed-fit single-breasted blazer in charcoal wool blend",
      "color": "charcoal grey",
      "style_tags": ["minimalist", "smart casual"],
      "category": "top",
      "price_range": "mid-range",
      "products": [
        {
          "title": "Oversized Wool Blazer - Grey",
          "url": "https://example.com/product/123",
          "thumbnail": "https://example.com/thumb.jpg",
          "price": "$89.99",
          "store": "ZARA",
          "snippet": "Relaxed-fit blazer in wool blend..."
        }
      ]
    },
    {
      "item": "straight-leg jeans",
      "description": "Mid-rise straight-leg jeans in medium wash denim",
      "color": "medium blue",
      "style_tags": ["casual", "classic"],
      "category": "bottom",
      "price_range": "budget",
      "products": []
    }
  ]
}

Notes

• The image URL must be publicly accessible
• Processing time: 5-15 seconds
• Typically identifies 2-6 items per outfit
• Product links are found via web search and may not always be available