Buscar productos

Búsqueda por palabras o por significado, con filtros como parámetros o escritos en la consulta.

On this page

Filtros escritos en la consulta
Filtros como parámetros
Recetas

This page isn't translated yet; we're showing it in Español.

GET /v1/search (MCP: search_products) busca por palabras, por una descripción, una marca, un modelo o un código de barras.

curl "https://bazar.boelabs.com/v1/search?q=licuadora%20oster%20hasta%2080%20d%C3%B3lares&limit=2"

{
  "results": [
    {
      "id": "lst_f1b7ca6365ff3f08",
      "title": "Licuadora Oster BLSTKAPWRD",
      "brand": "Oster",
      "store": { "id": "damasco-ve", "name": "Damasco" },
      "url": "https://www.damascovzla.com/licuadora-oster-blstkapwrd-d0001227/p",
      "categories": ["Electrodomésticos", "Línea Menor", "Licuadoras"],
      "price": { "amount": "53.00", "minor": 5300, "currency": "USD" },
      "converted": {
        "amount": "46739.48",
        "minor": 4673948,
        "currency": "VES",
        "rate": 881.8769,
        "rateDate": "2026-10-20"
      },
      "availability": "in_stock",
      "alsoSoldBy": 0,
      "observedAt": "2026-10-20T06:06:49.896Z",
      "stale": false,
      "match": "all_terms"
    }
  ],
  "nextCursor": "MjplMGJjYmM2YzQwYTI",
  "facets": {
    "stores": [{ "id": "damasco-ve", "name": "Damasco", "results": 40 }],
    "categories": [{ "name": "Licuadoras", "results": 17 }]
  },
  "applied": {
    "q": "licuadora oster",
    "currency": "USD",
    "maxPrice": 80,
    "sort": "relevance",
    "limit": 2,
    "semantic": true,
    "interpreted": { "from": "licuadora oster hasta 80 dólares", "phrases": ["hasta 80 dólares"] }
  }
}

Filtros escritos en la consulta

Bazar entiende una tienda ("en Damasco"), un rango de precio ("hasta 80 dólares", "entre 100 y 200 USD"), un orden ("más barato", "más caro") y "disponible". Lo que leyó lo quita de q y lo informa en applied.interpreted.

Un número suelto no es un precio: "televisor 55 pulgadas" se busca tal cual.
Los parámetros explícitos siempre ganan sobre lo leído.
interpret=false busca q exactamente como se escribió.

Filtros como parámetros

Parámetro	Para qué
`q`	Palabras, una descripción ("algo para enfriar el cuarto"), una marca, un modelo o un código de barras. Máximo 200 caracteres.
`stores`	Ids de tienda separados por coma (ver Tiendas): una para una sola tienda, varias para comparar. Máximo 20.
`category`	Solo productos cuya categoría propia (el último nivel) contiene el texto. Usa los nombres de `facets.categories`.
`inStock`	`true`: solo ofertas en stock según la tienda.
`currency`, `minPrice`, `maxPrice`	Rango de precio en unidades mayores (`maxPrice=100`). Necesita `currency` (USD o VES).
`convert`	Con `currency`: las ofertas en la otra moneda se convierten a la tasa BCV para filtrarlas y ordenarlas juntas (por defecto). `false` deja solo las de `currency`.
`sort`	`relevance` (por defecto), `price_asc` o `price_desc`. Los órdenes por precio necesitan `currency` y solo incluyen resultados que nombran todas las palabras.
`maxPerStore`	Como mucho N resultados por tienda. La relevancia ya mezcla tiendas; úsalo para variedad estricta (por ejemplo, `2` con `price_asc`).
`city`, `subdivision`, `latitude`/`longitude`/`radiusKm`	Solo ofertas de una sucursal o zona en ese lugar (ver Filtrar por lugar).
`country`	ISO 3166-1, por ejemplo `VE`.
`limit`	Resultados por página, de 1 a 50 (10 por defecto).
`cursor`	La página siguiente (ver Paginación).

Recetas

"La licuadora más barata": q=licuadora&sort=price_asc&currency=USD, o simplemente q=licuadora más barata.
Si aparecen accesorios (controles para "televisor"): repite con category tomado de facets.categories, por ejemplo category=Televisores.
Variedad entre tiendas: maxPerStore=2.
Un código de barras: q=7591196006479 devuelve solo coincidencias exactas (match: identifier).

Cuando un resultado tiene alsoSoldBy mayor que 0, otras tiendas venden el mismo código de barras: compáralo.