TurbodatoDocs
Referencia

Exportar el catálogo

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.

Para cargar a un BI o a una planilla. Devuelve todos los productos que pasan los filtros, sin paginar: page y limit se ignoran.

Cada fila es un producto. Cada columna de precio se llama Sitio - Precio Final, Sitio - Precio Lista, y así con cada valor de priceColumns. La celda es la oferta más barata de ese sitio ese día, y queda vacía si no hubo ninguna.

Las columnas de producto se llaman SKU, EAN, Product ID, Marca, Producto y Categoría. Product ID es el ID de la publicación en tu sitio propio.

Es una llamada pesada: programala una vez por día, después del relevamiento, y no la pongas en un loop.

GET
/export

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
format?string

Formato del archivo. Cualquier otro valor devuelve CSV.

Default"csv"
Value in"csv""excel""json"
sites?string

Qué sitios incluir, por nombre exacto (el siteName de /data o el name de /filters), separados por coma. Sin el parámetro van todos.

dataColumns?string

Columnas de producto, separadas por coma. Valores: sku, ean, productId, marca, producto, categoria.

Default"sku,marca,producto"
priceColumns?string

Columnas por cada sitio, separadas por coma. Valores: precioFinal, precioLista, descuento (porcentaje entero), cantidad, cuotas (cantidad y valor de la cuota), seller y url.

Default"precioFinal"
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"

Cuerpo de la respuesta

El archivo, con Content-Disposition: attachment. Se llama turbodato-export.csv, turbodato-export.xlsx o turbodato-export.json según el formato.

response?string
Ejemplo de request
curl "https://api.turbodato.com/v1/export" \  -H "X-API-Key: $TURBODATO_API_KEY"
Ejemplo de respuesta
[  {    "SKU": "UN55DU7000GCZB",    "Marca": "Samsung",    "Producto": "Smart TV Samsung 55\" Crystal UHD 4K DU7000",    "Tu Tienda - Precio Final": 899999,    "Mercado Libre - Precio Final": 849999,    "Frávega - Precio Final": 879999  }]