# makeup.land

> Israeli professional cosmetics retailer and e-commerce platform —
> Hebrew-RTL storefront with bilingual product data, semantic shade
> search, virtual lip + cheek try-on, and a dual-tender pricing model
> (ILS shekels + ℳ-credit wallet).

## What we are

- Catalog: ~1,550 products across 34+ brands.
- Operator: A.T. Hafakot Ltd. (ח.פ. 513942789).
- Languages: Hebrew (primary) + English where enriched.
- Two physical branches: Hameyasdim 52, Zikhron Yaakov; ההסתדרות 177, Haifa.
- Online: [https://makeup.land](https://makeup.land).

## What makes us different

- **Semantic shade search** — ΔE-ranked color match by hex code or photo.
  Filter by hue family (nude, coral, brown, ...) — see [/api/v1/products](https://makeup.land/api/v1/products?near_hex=%23C2185B).
- **Virtual try-on** — MediaPipe-based AR for compatible lipstick and blush.
- **ℳ-credits dual-tender wallet** — earn 5%+ on every paid order; redeem
  at parity (1ℳ = ₪1) as ILS-discount, or buy selected SKUs entirely in
  credits.
- **Authorized brand distribution** — official partner of [Yarin Shahaf](https://www.yarin-shahaf.co.il/%D7%9E%D7%99%D7%99%D7%A7%D7%90%D7%A4%D7%9C%D7%A0%D7%93)
  (Hebrew Wikipedia entity); designated online shop of [Yossi Bitton's B Cosmic line](https://yb.makeup/products)
  (6-language Wikipedia entity); authorized Israeli distributor of
  [da Vinci cosmetic brushes](https://www.davinci-makeupbrushes.com/en/cosmetic-brushes/contact/list-of-agents-distributors.html?land=IL)
  (German manufacturer, Defet family).

## How agents work with us

| Surface | Where | What it gives you |
|---------|-------|-------------------|
| OpenAPI 3.1 spec | [https://makeup.land/openapi.json](https://makeup.land/openapi.json) | Full V1 API description with scopes, operationIds, error envelopes |
| Auth skill manifest | [https://makeup.land/auth.md](https://makeup.land/auth.md) | WorkOS-format guide to obtaining bearer tokens |
| OAuth Protected Resource | [https://makeup.land/.well-known/oauth-protected-resource](https://makeup.land/.well-known/oauth-protected-resource) | RFC 9728 metadata |
| Long-form handbook | [https://makeup.land/llms-full.txt](https://makeup.land/llms-full.txt) | API quickstart, error codes, dual-tender pricing model |
| Pricing | [https://makeup.land/pricing.md](https://makeup.land/pricing.md) | Product, ℳ-credit, shipping, refund policy |
| Brand directory | [https://makeup.land/llms-brands.txt](https://makeup.land/llms-brands.txt) | Brand list with slugs |
| Product feeds | [https://makeup.land/api/merchant/feed](https://makeup.land/api/merchant/feed) (RSS), [https://makeup.land/api/merchant/openai/products](https://makeup.land/api/merchant/openai/products) (ACP JSONL) | Catalog ingestion |

## Quick API examples

```bash
# Catalog browse — anonymous (tag, brand, near_hex, hue_family, sort)
curl -s "https://makeup.land/api/v1/products?tag=lipstick&limit=5"
curl -s "https://makeup.land/api/v1/products?near_hex=%23C2185B&limit=5"

# Per-customer rewards projection — bearer required
curl -s "https://makeup.land/api/v1/products?phone=%2B972501234567&limit=5" \
  -H "Authorization: Bearer ml_<your-token>"

# Cart, payment-links, best-deals, opportunities — bearer + phone
curl -s "https://makeup.land/api/v1/cart?phone=%2B972501234567" \
  -H "Authorization: Bearer ml_<your-token>"
```

Tokens are issued manually — write to `shop@makeup.land` with the
intended use case (see [auth.md](https://makeup.land/auth.md)).

## Contact

- WhatsApp: `+972-77-2233344`
- Email: `shop@makeup.land`
- Hours: Sunday–Thursday 09:00–18:00, Friday 09:00–13:00, Saturday closed