TurbodatoDocs
Referencia

Productos y precios

Los productos del tablero con todas sus ofertas del día, paginados. Es la misma matriz que ves en el dashboard, servida como JSON.

El endpoint principal. Cada producto trae las ofertas que se relevaron ese día: una por publicación, con su sitio, su vendedor, precio de lista, precio final, descuento, cuotas y link.

  • columns describe el tablero, no la página: vienen siempre todas las columnas, en su orden, aunque un producto no tenga oferta en varias de ellas.
  • La primera columna no es necesariamente la tuya. Tu sitio es el que coincide con mainSiteId.
  • referenceDate dice qué día se devolvió. Sin date, es el día del último relevamiento.

Si estás recorriendo el catálogo entero, pedí stats=false: te ahorrás las dos cuentas más caras, que vienen idénticas en todas las páginas.

GET
/data

Autenticación

apiKey
headerX-API-Key<token>

Tu API key, que empieza con td_live_. Se crea en Configuración → API y se muestra completa una sola vez.

Parámetros de query

clientId?string

El tablero, con el id que devuelve /clients. Opcional si tu key alcanza un solo tablero; obligatorio a partir del segundo.

Formatuuid
page?integer

Número de página, base 1. Fuera de rango se recorta al límite más cercano.

Range1 <= value <= 100000
Default1
limit?integer

Productos por página. Fuera de rango se recorta al límite más cercano, así que limit=5000 devuelve 200.

Range1 <= value <= 200
Default20
brand?string

Marca, coincidencia exacta. Varias con barra vertical, Samsung|LG. Los valores válidos salen de /filters.

category?string

Categoría, coincidencia exacta. Varias con barra vertical. Los valores válidos salen de /filters.

site?string

Nombre del sitio, coincidencia parcial y sin distinguir mayúsculas: site=mercado encuentra Mercado Libre. Acota las ofertas, no los productos.

seller?string

Vendedor, 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?string

Búsqueda libre en nombre, marca, EAN y SKU. Todos los términos tienen que aparecer; los acentos y las mayúsculas no cuentan.

semaphore?string

Color del semáforo del producto. Cualquier otro valor se ignora.

Value in"red""yellow""green"
favorites?boolean

true deja sólo los productos marcados con estrella por alguien del equipo.

Defaultfalse
date?string

Día a consultar, en YYYY-MM-DD. Sin él, el día del último relevamiento. Los días disponibles salen de /dates.

Formatdate
order_by?string

Orden de los productos, sobre tu sitio propio: price* por el precio de tu publicación ese día, discount* por su descuento. Los productos sin ese dato van al final. Sin el parámetro, nombre de la A a la Z.

Value in"priceASC""priceDESC""discountASC""discountDESC"
stats?boolean

false omite totalMatches, cheapestSiteName y cheapestSitePercent de infoCards. Son las dos consultas más caras y describen el catálogo entero, así que vienen iguales en la página 1 y en la 17. Recomendado al paginar todo el catálogo.

Defaulttrue
exclude_international?boolean

true deja afuera las compras internacionales: publicaciones con envío desde el exterior. Es lo que hace la matriz del dashboard por defecto. Sólo lo acepta /data.

Defaultfalse

Cuerpo de la respuesta

Una página de productos con sus ofertas del día.

application/json
  1. response
columns*array<>

Todas las columnas del tablero, en su orden. No dependen de la página.

anchors*array<>

Los productos de esta página.

pagination*
infoCards*

Números del catálogo entero ese día. No dependen de los filtros ni de la página.

mainSiteId*|

El siteId de tu sitio propio, contra el que se compara todo.

Formatuuid
referenceDate*|

El día que se devolvió, en YYYY-MM-DD. No lo asumas, leelo.

Formatdate
Ejemplo de request
curl "https://api.turbodato.com/v1/data" \  -H "X-API-Key: $TURBODATO_API_KEY"
Ejemplo de respuesta
{  "columns": [    {      "siteId": "0b6f2c1a-5d3e-4f7a-8b9c-1d2e3f4a5b6c",      "siteName": "Tu Tienda",      "order": 0    },    {      "siteId": "7e8f9a0b-1c2d-4e3f-8a5b-6c7d8e9f0a1b",      "siteName": "Mercado Libre",      "order": 1    },    {      "siteId": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",      "siteName": "Frávega",      "order": 2    }  ],  "anchors": [    {      "suggestedPrice": 899999,      "id": "5a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",      "ean": "8806095467894",      "sku": "UN55DU7000GCZB",      "sourceProductId": null,      "name": "Smart TV Samsung 55\" Crystal UHD 4K DU7000",      "brand": "Samsung",      "category": "Televisores",      "subcategory": "Smart TV",      "url": "https://www.tutienda.com.ar/smart-tv-samsung-55-du7000",      "isFavorite": true,      "imageUrls": [        "https://http2.mlstatic.com/D_NQ_NP_000000-MLA00000000000_000000-O.webp"      ],      "missingReportSiteIds": [],      "matches": [        {          "id": "9c8b7a6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",          "productId": "TT-55DU7000",          "siteName": "Tu Tienda",          "siteId": "0b6f2c1a-5d3e-4f7a-8b9c-1d2e3f4a5b6c",          "sellerName": "Tu Tienda",          "sellerId": "4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f7a",          "quantity": 1,          "priceList": 949999,          "realPrice": 899999,          "discountPercent": 5.26,          "url": "https://www.tutienda.com.ar/smart-tv-samsung-55-du7000",          "date": "2026-10-16T00:00:00.000Z",          "hasOpenReport": false,          "installments": [            {              "cantidad": 6,              "precio": 149999.83,              "interes": 0,              "total": 899999,              "medios": [                {                  "banco": null,                  "tarjeta": "Visa"                }              ]            }          ],          "primePrice": null,          "officialStore": false,          "breaksSuggestedPrice": false        },        {          "id": "1f2e3d4c-5b6a-4978-8a6b-5c4d3e2f1a0b",          "productId": "MLA1428765432",          "siteName": "Mercado Libre",          "siteId": "7e8f9a0b-1c2d-4e3f-8a5b-6c7d8e9f0a1b",          "sellerName": "Electro del Sur",          "sellerId": "6a7b8c9d-0e1f-4a2b-9c3d-4e5f6a7b8c9d",          "quantity": 1,          "priceList": 999999,          "realPrice": 849999,          "discountPercent": 15,          "url": "https://articulo.mercadolibre.com.ar/MLA-1428765432",          "date": "2026-10-16T00:00:00.000Z",          "hasOpenReport": false,          "installments": [            {              "cantidad": 12,              "precio": 70833.25,              "interes": 0,              "total": 849999,              "medios": [                {                  "banco": "Galicia",                  "tarjeta": "Visa"                },                {                  "banco": "Galicia",                  "tarjeta": "Mastercard"                }              ]            }          ],          "primePrice": null,          "officialStore": false,          "breaksSuggestedPrice": true        }      ]    }  ],  "pagination": {    "page": 1,    "limit": 20,    "total": 234,    "totalPages": 12  },  "infoCards": {    "totalAnchors": 234,    "lastUpdate": "2026-10-16T09:41:12.000Z",    "totalMatches": 1872,    "cheapestSiteName": "Mercado Libre",    "cheapestSitePercent": 41  },  "mainSiteId": "0b6f2c1a-5d3e-4f7a-8b9c-1d2e3f4a5b6c",  "referenceDate": "2026-10-16"}

Días consultables GET

Los días que podés pasar en el parámetro date, del más nuevo al más viejo. Cubre los últimos 90 días hasta el último con datos.

Resumen del semáforo GET

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.