TurbodatoDocs

API de Turbodato

Sacá tus precios contra la competencia por API. Creá una API key, hacé el primer request con curl y leé la respuesta en cinco minutos.

La API te da los mismos datos que ves en el dashboard, como JSON: cada producto de tu catálogo con el precio de cada competidor y cada seller, del mismo día. Sirve para llevarlos a tu ERP, a un BI o a una planilla, o para armar tus propias alertas.

Es de sólo lectura. No hay repricing ni endpoints que escriban: el dato sale, la decisión de precio queda en tu equipo.

De un vistazo

  • Base URL: https://api.turbodato.com/v1
  • Autenticación: header X-API-Key con una key td_live_…
  • Métodos: sólo GET. Todo es idempotente.
  • Formato: JSON UTF-8. /export además devuelve CSV y Excel.
  • Límite: 60 llamadas por minuto por key.
  • Versión: v1 es un contrato congelado. Pueden aparecer campos nuevos; ninguno se saca ni se renombra.

Tu primer request

Creá una API key

En el dashboard, entrá a Configuración → API y tocá Crear API key. Ponele un nombre que diga dónde se usa, por ejemplo "Integración ERP", así sabés cuál revocar el día que haga falta.

La key se muestra completa una sola vez. Copiala en ese momento y guardala en una variable de entorno:

Terminal
export TURBODATO_API_KEY="td_live_..."

Pedí la primera página de precios

Si tu key alcanza un solo tablero, no hace falta decir cuál: la API lo resuelve sola.

Terminal
curl "https://api.turbodato.com/v1/data?limit=5" \
  -H "X-API-Key: $TURBODATO_API_KEY"

Si tenés más de un tablero, elegí uno

Si tu key alcanza dos o más tableros, la API responde 400 hasta que le digas cuál querés. Pedí la lista a /clients y pasá el id como clientId:

Terminal
curl "https://api.turbodato.com/v1/clients" \
  -H "X-API-Key: $TURBODATO_API_KEY"
# [{ "id": "3f1c9a2e-7b4d-4e8a-9c1f-2a6b8d0e4f17", "name": "Electro" }, ...]

curl "https://api.turbodato.com/v1/data?clientId=3f1c9a2e-7b4d-4e8a-9c1f-2a6b8d0e4f17&limit=5" \
  -H "X-API-Key: $TURBODATO_API_KEY"

Qué te devuelve

Una página de productos con todas sus ofertas del día. Recortado a un producto y dos ofertas:

GET /data
{
  "columns": [
    { "siteId": "0b6f2c1a-…", "siteName": "Tu Tienda", "order": 0 },
    { "siteId": "7e8f9a0b-…", "siteName": "Mercado Libre", "order": 1 }
  ],
  "anchors": [
    {
      "id": "5a1b2c3d-…",
      "sku": "UN55DU7000GCZB",
      "name": "Smart TV Samsung 55\" Crystal UHD 4K DU7000",
      "brand": "Samsung",
      "category": "Televisores",
      "matches": [
        { "siteName": "Tu Tienda", "sellerName": "Tu Tienda", "priceList": 949999, "realPrice": 899999 },
        { "siteName": "Mercado Libre", "sellerName": "Electro del Sur", "priceList": 999999, "realPrice": 849999 }
      ]
    }
  ],
  "pagination": { "page": 1, "limit": 5, "total": 234, "totalPages": 47 },
  "mainSiteId": "0b6f2c1a-…",
  "referenceDate": "2026-10-16"
}

Tres cosas para leerla bien:

  • Tu sitio es el de mainSiteId, no necesariamente la primera columna. Es la vara contra la que se compara todo.
  • referenceDate es el día de todos los precios de la respuesta. Sin el parámetro date, es el día del último relevamiento. Nunca mezclamos días: el Smart TV a $ 849.999 en Mercado Libre y el tuyo a $ 899.999 son del mismo relevamiento.
  • Cada oferta es una publicación en un sitio, con su vendedor cuando el sitio lo informa. Un producto puede tener cinco ofertas en Mercado Libre, una por publicación.

El esquema completo, campo por campo, está en la referencia de /data.

Y después

Autenticación

Qué ve una key, cómo guardarla y cómo revocarla.

Convenciones

Filtros, paginación, fechas y el día de referencia.

Recetas

Exportar los productos en rojo a una planilla, sondear antes de bajar, alertas de PVP.

Referencia

Los ocho endpoints con parámetros, respuestas y código.

¿Preferís preguntar en vez de programar?

Los mismos datos están disponibles por MCP para Claude y ChatGPT: le preguntás "¿quién está debajo de mi PVP hoy?" y contesta con estos números.

Equipo y permisos

Cómo invitar a tu equipo a Turbodato por link, elegir a qué tableros entra cada persona y limitar qué productos ve. Roles, lugares y API keys.

Autenticación

Cómo se autentica la API de Turbodato con el header X-API-Key, qué tableros y productos ve cada key, y cómo guardarla y revocarla.

En esta página

Tu primer requestCreá una API keyPedí la primera página de preciosSi tenés más de un tablero, elegí unoQué te devuelveY después