Endpoint - Sinónimos

Los sinónimos relacionan palabras que el cliente busca con palabras presentes en tu catalogo. Cuando un cliente busca hidra, Mibizum puede devolverle resultados de hidratante si tienes ese sinónimo activo.

Los sinónimos tienen tres origenes (source):

• manual: los creas tu desde el panel o por API.
• learned: los crea automáticamente Smart Mibizum cuando detecta un typo claro (oanteni -> pantenol).
• suggested: el aprendizaje IA los propone pero no los aplica todavia; aparecen en /sugerencias del panel para que confirmes.

GET /v1/{tenant}/synonyms

Lista los sinónimos del tenant.

curl https://api.mibizum.io/v1/tu-tienda/synonyms \
  -H "Authorization: Bearer mb_sk_live_..."

Parámetros

Parámetro	Default	Descripción
source	(todos)	Filtra por manual / learned / suggested
enabled	(ambos)	true para activos, false para inactivos
q	(vacio)	Filtro de texto sobre word y las variantes
page, page_size	1, 20	Paginación

Respuesta

{
  "rows": [
    {
      "id": 42,
      "word": "hidra",
      "synonyms": ["hidratante", "hidratacion"],
      "source": "manual",
      "confidence": null,
      "enabled": true,
      "created_at": "2026-05-01T10:30:00Z",
      "updated_at": "2026-05-01T10:30:00Z"
    }
  ],
  "total": 1
}

POST /v1/{tenant}/synonyms

Crea un sinónimo nuevo.

curl -X POST https://api.mibizum.io/v1/tu-tienda/synonyms \
  -H "Authorization: Bearer mb_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "word": "hidra",
    "synonyms": ["hidratante", "hidratacion"]
  }'

Limitación importante

Un sinónimo de una palabra no se expande a una frase de varias palabras en el motor. Si la query del cliente es 1 token y el destino son 2, no matchea. Ver Guía: Sinónimos de 1 a N palabras para la heurística correcta.

PATCH /v1/{tenant}/synonyms/{id}

Actualiza un sinónimo (variantes, habilitado).

curl -X PATCH https://api.mibizum.io/v1/tu-tienda/synonyms/42 \
  -H "Authorization: Bearer mb_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "enabled": false }'

DELETE /v1/{tenant}/synonyms/{id}

Borra un sinónimo. Esta operación es irreversible: el historial del aprendizaje IA queda, pero el sinónimo deja de aplicarse.