makeup.land

{
  "name": "makeup.land",
  "description": "Israeli professional cosmetics retailer. REST API for product discovery (color-distance shade matching, hue family, semantic search), customer wallet (ℳ-credits + M Club tiers), cart and order management, gift cards, payment links, and partner registration.",
  "url": "https://makeup.land/api/v1",
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "authentication": {
    "schemes": [
      "bearerAuth",
      "phoneIdentifier"
    ]
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "shade_match",
      "name": "Shade matching by hex",
      "description": "Find products carrying a swatch close to a target hex color, ranked by color distance (redmean-weighted RGB). Supports hue_family refinement (white, black, gray, red, coral, orange, brown, nude, beige, yellow, green, blue, purple, pink) and per-customer reward projection.",
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "tags": [
        "search",
        "color",
        "products",
        "cosmetics"
      ],
      "examples": [
        "Find lipsticks close to #C2185B",
        "Match a foundation to my skin tone #E8D4B8 with warm undertone"
      ],
      "security": [
        {},
        {
          "bearerAuth": []
        }
      ]
    },
    {
      "id": "product_search",
      "name": "Product search and filtering",
      "description": "Search via `q` (cross-lingual natural-language query — Hebrew, English, transliteration all return semantically-equivalent results), or filter via `tag` (EXACT-string match against Hebrew-stored tags), `brand`, or `sort` (price / popularity / Bayesian-shrunk rating). Returns ILS and ℳ-credit prices side-by-side for tender-aware checkout.",
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "tags": [
        "search",
        "catalog",
        "products"
      ],
      "examples": [
        "List the top 10 most-popular lipsticks under ₪150",
        "Show all NYX products with rating above 4.5"
      ],
      "security": [
        {},
        {
          "bearerAuth": []
        }
      ]
    },
    {
      "id": "customer_lookup",
      "name": "Customer lookup and wallet balance",
      "description": "Lookup customer by phone (E.164). Returns tags, ℳ-credit wallet balance, M Club tier, opportunity claims.",
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "tags": [
        "customers",
        "loyalty",
        "wallet"
      ],
      "examples": [
        "Get balance for +972501234567"
      ],
      "security": [
        {
          "bearerAuth": []
        }
      ]
    },
    {
      "id": "cart_management",
      "name": "Cart add / update / clear",
      "description": "Manipulate a customer's persistent cart. Supports tender selection (ils vs credits), gift-personalization. Idempotency-Key is not enforced. Stock-gated; credits-tender items wallet-gated.",
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "tags": [
        "cart",
        "checkout"
      ],
      "examples": [
        "Add product prod_x variant var_y quantity 2 for +972501234567",
        "Switch line li_abc from ils to credits tender"
      ],
      "security": [
        {
          "bearerAuth": [],
          "phoneIdentifier": []
        }
      ]
    },
    {
      "id": "order_history",
      "name": "Order history and status",
      "description": "List a customer's recent orders with 6-axis status (order/payment/fulfillment/delivery/return/review).",
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "tags": [
        "orders",
        "history"
      ],
      "examples": [
        "List the 5 most recent orders for +972501234567"
      ],
      "security": [
        {
          "bearerAuth": []
        }
      ]
    },
    {
      "id": "gift_card_redeem",
      "name": "Gift card validate and redeem",
      "description": "Validate a gift card balance (public, no auth) or redeem against an order (scope: full or giftcards). Partner-issued + internal cards unified.",
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "tags": [
        "gift-cards",
        "payments"
      ],
      "examples": [
        "Check balance for code GML-XXXX-XXXX-XXXX",
        "Redeem code GML-XXXX-XXXX-XXXX against order ord-<uuid>"
      ],
      "security": [
        {},
        {
          "bearerAuth": []
        }
      ]
    },
    {
      "id": "register_customer",
      "name": "Customer registration",
      "description": "Generic registration orchestrator — create or look up a customer, compute partner-config-driven tags, fire WhatsApp template and partner webhooks. Designed for inbound WA proof of phone ownership. Scope: full or register, on a token with a registration source configured.",
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "tags": [
        "customers",
        "onboarding",
        "whatsapp"
      ],
      "examples": [
        "Register +972501234567 with tags=['first-touch']"
      ],
      "security": [
        {
          "bearerAuth": []
        }
      ]
    }
  ]
}