Resumen del semáforo
Cuántos productos están en rojo, amarillo y verde contra la competencia, ese día. La misma cuenta que las tarjetas del dashboard, sin la configuración de tu vista.
Cuenta sobre el mismo conjunto que devolvería /data con esos filtros, así que el
contador y la lista no se contradicen. page y limit se aceptan pero no cambian nada:
la cuenta es siempre sobre todo el catálogo filtrado.
Cada producto se clasifica comparando, ese día, el precio más barato de cada columna del tablero contra el de tu sitio propio (por unidad, si tu tablero compara por pack):
- Rojo: tu precio es el más alto de la fila y al menos un competidor está más barato.
- Verde: tu precio es el más bajo de la fila y al menos un competidor está más caro.
- Amarillo: el resto. Hay competidores más baratos y más caros a la vez, o todos están al mismo precio.
total son los productos comparables: los que ese día tienen precio propio y al menos un
competidor con precio. Un producto que no publicás ese día no entra en ninguna banda, así
que las tres pueden no sumar tu catálogo completo.
Puede no coincidir con las tarjetas que ves en pantalla: la API no aplica las columnas que ocultaste, el pack elegido ni el precio ajustado por cuotas, e incluye las compras internacionales, que la matriz esconde por defecto.
apiKeyX-API-Key<token>Tu API key, que empieza con td_live_. Se crea en Configuración → API y se muestra
completa una sola vez.
clientId?stringEl tablero, con el id que devuelve /clients. Opcional si tu key alcanza un solo
tablero; obligatorio a partir del segundo.
uuidbrand?stringMarca, coincidencia exacta. Varias con barra vertical, Samsung|LG. Los valores válidos salen de /filters.
category?stringCategoría, coincidencia exacta. Varias con barra vertical. Los valores válidos salen de /filters.
site?stringNombre del sitio, coincidencia parcial y sin distinguir mayúsculas: site=mercado
encuentra Mercado Libre. Acota las ofertas, no los productos.
seller?stringVendedor, por su nombre normalizado (el que devuelve /filters). Coincidencia exacta;
varios con barra vertical. Deja sólo los productos que ese vendedor ofrece ese día, y
sólo sus ofertas.
text?stringBúsqueda libre en nombre, marca, EAN y SKU. Todos los términos tienen que aparecer; los acentos y las mayúsculas no cuentan.
semaphore?stringColor del semáforo del producto. Cualquier otro valor se ignora.
"red""yellow""green"favorites?booleantrue deja sólo los productos marcados con estrella por alguien del equipo.
falsedate?stringDía a consultar, en YYYY-MM-DD. Sin él, el día del último relevamiento.
Los días disponibles salen de /dates.
dateLos contadores del semáforo.
application/json- response
total*integerProductos comparables ese día.
red*integerProductos donde tu precio es el más alto de la fila y al menos un competidor está más barato.
yellow*integerProductos con competidores más baratos y más caros a la vez, o todos al mismo precio.
green*integerProductos donde tu precio es el más bajo de la fila y al menos un competidor está más caro.
redPercent*integerPorcentaje de total, redondeado a entero.
yellowPercent*integerPorcentaje de total, redondeado a entero.
greenPercent*integerPorcentaje de total, redondeado a entero.
curl "https://api.turbodato.com/v1/semaphore" \ -H "X-API-Key: $TURBODATO_API_KEY"{ "total": 198, "red": 45, "yellow": 61, "green": 92, "redPercent": 23, "yellowPercent": 31, "greenPercent": 46}Productos y precios GET
Los productos del tablero con todas sus ofertas del día, paginados. Es la misma matriz que ves en el dashboard, servida como JSON.
Exportar el catálogo GET
El catálogo entero en un archivo CSV, Excel o JSON, sin paginación. Una fila por producto y una columna de precio por sitio.