# Commerce & Marketplaces

Part of the HebrewCore documentation. Web: https://hc.itsbaba.com/docs#solution-commerce · Whole docs: https://hc.itsbaba.com/docs.md · Index: https://hc.itsbaba.com/llms.txt

Product titles, descriptions, promotions and checkout copy in Hebrew and Russian, with every price, size, model number and brand name exactly as your catalog has it.

## What to Use

| Need | Use |
| --- | --- |
| Translate a catalog | `/v1/translate/batch` with `protect: true`, up to 50 items per call. |
| Brand, product and program names | [Account terms](https://hc.itsbaba.com/docs#terms) once for the whole catalog; `protected_terms` for one-off names. |
| Your house vocabulary | `glossary`, for example `"warranty": "אחריות"`. |
| Price and range lines on screen | `/v1/wrap` or `display_runs`, so `₪149.90` and `3–5` never split or mirror. |
| Search in Hebrew and Latin letters | `/v1/detect` on the query, `/v1/transliterate` for Latin-letter search keys. |

## Example

```http
POST /v1/translate/batch
{
  "items": [
    "Wireless Earbuds Pro, 2 pack",
    "Free shipping on orders over $50",
    "Only {stock} left in stock",
    "Model WEP-2210-BLK, 1-year warranty"
  ],
  "target_lang": "he",
  "protect": true,
  "protected_terms": ["Wireless Earbuds Pro"],
  "glossary": { "warranty": "אחריות" }
}

{
  "results": [
    { "text": "Wireless Earbuds Pro, מארז של 2", "lang": "he", "dir": "rtl", "protection": { "status": "ok", … } },
    { "text": "משלוח חינם בהזמנות מעל $50", "lang": "he", "dir": "rtl", "protection": { "status": "ok", … } },
    { "text": "נותרו רק {stock} במלאי", "lang": "he", "dir": "rtl", "protection": { "status": "ok", … } },
    { "text": "דגם WEP-2210-BLK, אחריות לשנה", "lang": "he", "dir": "rtl", "protection": { "status": "ok", … } }
  ],
  "usage": { "characters": 131 }
}
```

## Pitfalls

- **Unusual model names.** Codes with digits are protected automatically; a plain-word product name ("Nimbus", "Aurora") is not. Add it to account terms.
- **Prices in a Hebrew line.** `dir="rtl"` alone can split a range or move a sign. Render `display_runs` or the `/v1/wrap` output.
- **Batch size.** A protected batch carries at most 20,000 characters in total; split long descriptions across calls.