TurbodatoDocs
Referencia

Valores para filtrar

Las marcas, categorías, sellers y sitios del tablero, escritos tal cual los aceptan los filtros. Consultalo antes de filtrar por coincidencia exacta.

brand, category y seller son coincidencia exacta: brand=Sams no encuentra nada. Este endpoint dice qué escribir.

  • sellers trae el nombre normalizado de cada vendedor: si tu organización unificó "FRAVEGA OFICIAL" bajo "Frávega", acá viene "Frávega", y eso es lo que va en seller=. Lista los sellers que tienen ofertas el último día con precios.
  • brands y categories salen de tu catálogo, ordenadas alfabéticamente.

La respuesta trae además otras claves que usa el dashboard para sus propios controles (por ejemplo, la lista de nombres de producto o las especificaciones técnicas). No forman parte de la integración: no te apoyes en ellas.

Se recalcula como mucho cada cinco minutos.

GET
/filters

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

Cuerpo de la respuesta

Los valores disponibles para cada filtro.

application/json
  1. response
categories*array<string>

Categorías del catálogo. Es lo que acepta category.

brands*array<string>

Marcas del catálogo. Es lo que acepta brand.

sellers*array<>

Vendedores con ofertas el último día con precios, uno por nombre normalizado. El name es lo que acepta seller.

sites*array<>

Los sitios del tablero.

[key: string]?any
Ejemplo de request
curl "https://api.turbodato.com/v1/filters" \  -H "X-API-Key: $TURBODATO_API_KEY"
Ejemplo de respuesta
{  "categories": [    "Aire acondicionado",    "Lavarropas",    "Televisores"  ],  "brands": [    "BGH",    "Drean",    "LG",    "Samsung"  ],  "sellers": [    {      "id": "6a7b8c9d-0e1f-4a2b-9c3d-4e5f6a7b8c9d",      "name": "Electro del Sur"    },    {      "id": "3e4f5a6b-7c8d-4e9f-8a0b-1c2d3e4f5a6b",      "name": "Frávega"    }  ],  "sites": [    {      "id": "0b6f2c1a-5d3e-4f7a-8b9c-1d2e3f4a5b6c",      "name": "Tu Tienda"    },    {      "id": "7e8f9a0b-1c2d-4e3f-8a5b-6c7d8e9f0a1b",      "name": "Mercado Libre"    },    {      "id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",      "name": "Frávega"    }  ]}

Ver si hay datos nuevos GET

Tres números baratos que dicen si el catálogo cambió desde tu última sincronización, sin bajar nada. Pensado para sondear seguido.

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.