Outfit

A fashion or outfit breakdown extracted from a styling video, lookbook, or get-ready clip. Captures the individual pieces and the overall styling. Only record brands, prices, and details actually shown or stated — omit otherwise.

Fields

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "vidextract.predefined.fashion_outfit.v1",
  "title": "Outfit",
  "description": "A fashion or outfit breakdown extracted from a styling video, lookbook, or get-ready clip. Captures the individual pieces and the overall styling. Only record brands, prices, and details actually shown or stated — omit otherwise.",
  "type": "object",
  "required": [
    "items"
  ],
  "additionalProperties": false,
  "properties": {
    "lookName": {
      "type": "string",
      "description": "Name or theme of the look if given, e.g. 'date-night dinner look'. Omit otherwise."
    },
    "occasion": {
      "type": "string",
      "description": "Occasion the outfit is styled for, e.g. 'wedding guest', 'office', 'night out'."
    },
    "style": {
      "type": "string",
      "description": "Overall aesthetic, lowercased — e.g. 'old money', 'streetwear', 'minimalist'."
    },
    "items": {
      "type": "array",
      "description": "The garments and accessories that make up the look, top to bottom.",
      "minItems": 1,
      "items": {
        "type": "object",
        "required": [
          "type"
        ],
        "additionalProperties": false,
        "properties": {
          "type": {
            "type": "string",
            "description": "The piece, e.g. 'pleated maxi dress', 'strappy heels', 'gold hoops'."
          },
          "color": {
            "type": "string",
            "description": "Color or pattern if shown. Omit otherwise."
          },
          "brand": {
            "type": "string",
            "description": "Brand if named or visible. Omit otherwise."
          },
          "priceText": {
            "type": "string",
            "description": "Price as stated, e.g. '$45'. Omit otherwise."
          }
        }
      }
    },
    "colorPalette": {
      "type": "array",
      "description": "Dominant colors of the overall look. Short color words.",
      "items": {
        "type": "string"
      }
    },
    "summary": {
      "type": "string",
      "description": "One or two sentences describing the look and how it's styled."
    }
  }
}

Use it via the API

Pass schemaId: "vidextract.predefined.fashion_outfit.v1" when you submit an extraction. The call returns an id immediately. Poll GET /v1/extractions/{id}/result (or register a webhook) for the structured result.

curl -s -X POST https://postreef.com/v1/extractions \
  -H "x-api-key: $VIDEXTRACT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
       "inputs": ["transcript", "comments"],
       "schemaId": "vidextract.predefined.fashion_outfit.v1"}'

Full request/response shape in the API reference; copy-paste poll loops in the API quickstart.