Endpoint - Sinonimos

Los sinonimos 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 sinonimo activo.

Los sinonimos tienen tres origenes (source):

• manual: los creas tu desde el panel o por API.
• learned: los crea automaticamente 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 sinonimos del tenant.

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

Parametros

Parametro	Default	Descripcion
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	Paginacion

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 sinonimo 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"]
  }'

Limitacion importante

Un sinonimo 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 Guia: Sinonimos de 1 a N palabras para la heuristica correcta.

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

Actualiza un sinonimo (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 sinonimo. Esta operacion es irreversible: el historial del aprendizaje IA queda, pero el sinonimo deja de aplicarse.