La Storefront API es una API REST pública para crear tiendas headless en Tiendanube. Con ella, desarrollas un frontend propio, web o mobile. Ese frontend consulta por API los productos y las categorías de la tienda, en lugar de usar un diseño de Tiendanube.
Es una opción para tiendas con equipo de desarrollo o agencia que necesitan una experiencia que un diseño no ofrece. Para la mayoría, el Nuevo Editor del diseño Ipanema resuelve la necesidad con menos desarrollo y mantenimiento.
Helpjuice Success Callout Title
La Storefront API no viene activa por defecto. Cada tienda necesita una habilitación manual antes de poder usarla.
¿En qué se diferencia headless de otras formas de personalizar mi tienda?
Headless significa que la tienda en línea se construye por fuera de Tiendanube y solo consulta datos por API. Hoy, la única herramienta de Tiendanube que funciona así es la Storefront API. Las otras tres herramientas que suelen confundirse con headless trabajan sobre la tienda en línea de Tiendanube.
| Herramienta | Qué es | ¿Es headless? |
|---|---|---|
| Nuevo Editor | Editor visual del diseño Ipanema, que arma la tienda con secciones y bloques sin código. | No |
| Tiendanube CLI y fork del diseño | Herramienta para que desarrolladores y agencias editen el código de un diseño. | No |
| NubeSDK | Toolkit que ejecuta el código de las apps dentro de la tienda en línea existente. | No |
| Storefront API | API que alimenta una tienda en línea separada, construida fuera de Tiendanube. | Sí |
Para conocer las secciones y los bloques del Nuevo Editor, consulta qué secciones puedes agregar con el diseño Ipanema.
¿Qué puedo consultar con la Storefront API y qué límites de uso tiene?
La Storefront API cubre el recorrido de descubrimiento de una tienda y entrega la compra al checkout alojado de Tiendanube. No requiere crear una app ni usar OAuth. Todos los endpoints parten de la URL base https://storefront-api.tiendanube.com/2026-11/stores/{store_id}/.
| Capacidad | Endpoint | Detalle |
|---|---|---|
| Listar productos publicados | GET /products | Devuelve hasta 200 por página. El parámetro fields elige los campos. |
| Buscar productos | GET /search/products | Devuelve solo la primera página de resultados. |
| Ver un producto | GET /products/{id_or_handle} | Incluye variantes e imágenes si se piden. |
| Listar categorías | GET /categories | Devuelve solo las categorías visibles. |
| Ver una categoría | GET /categories/{id_or_handle} | Se consulta por ID o handle. |
| Cotizar un envío | POST /shipping-options | Calcula por variante, cantidad y código postal. |
| Iniciar el checkout | POST /checkouts | Devuelve un checkout_url y acepta un cupón. |
Los campos personalizados se piden con fields=custom_fields. Solo se devuelven los que creó la tienda, nunca los de las apps.
Sin token desde el navegador, el límite es de 120 solicitudes por minuto por tienda e IP. Con token desde un servidor, es de 1,200 solicitudes por minuto por tienda. Si el servidor envía el encabezado X-LinkedStore-Buyer-IP, el límite pasa a 120 por minuto por cada IP de quien compra.
Para ver la referencia técnica completa, consulta:
Documentación oficial de la Storefront API.
¿Qué pierde mi tienda al crear un frontend headless?
Al ir headless, tu equipo o agencia asume todo lo que Tiendanube resuelve en la tienda en línea. La tienda sigue usando el administrador (catálogo, stock, precios y cupones), Pago Nube, Envío Nube y el checkout alojado por Tiendanube.
| Qué se pierde | Qué implica |
|---|---|
| Nuevo Editor | No hay edición visual ni vista previa en vivo. Cada cambio de diseño requiere desarrollo. |
| Diseños y sus actualizaciones | Las mejoras y correcciones del diseño Ipanema no llegan solas. |
| Apps de la tienda | Las apps que agregan elementos en la tienda en línea pueden no funcionar igual. Se valida caso por caso. |
| Carrito | La API no incluye un endpoint de carrito, por lo que el frontend construye el suyo. |
| Cuenta de quien compra, páginas y blog | La API no los cubre. Se construyen en el frontend o con otra herramienta. |
| Hosting, dominio y SSL | Pasan a ser responsabilidad de la tienda o de su proveedor. |
| SEO | Tiendanube deja de gestionar el sitemap, las meta tags y las URLs. |
| Métricas de la tienda | Las estadísticas de visitas y del recorrido de compra pueden quedar incompletas. Se valida caso por caso. |
| Soporte sobre el frontend | La atención de Tiendanube cubre el administrador y el checkout. El frontend queda a cargo del equipo o la agencia. |
En general, un proyecto headless cuesta más que un diseño estándar. Tu equipo o agencia asume el hosting, el desarrollo y el mantenimiento. No hay un valor fijo, porque depende del alcance.
¿Cuándo me conviene usar la Storefront API y cuándo no?
La Storefront API conviene cuando la experiencia de compra diferencia a la marca. También hace falta un equipo que sostenga el frontend propio.
| Situación | Encaje y alternativa |
|---|---|
| Tienda enterprise con equipo de desarrollo propio | Alto. Permite controlar la experiencia, el rendimiento y el stack. |
| Agencia que arma tiendas a la medida | Alto. La tienda debe saber qué pierde y que depende de la agencia. |
| Marca que migra desde otras plataformas como VTEX o Shopify Hydrogen | Alto. Puede conservar su frontend y cambiar solo el backend de comercio, lo que reduce el costo de la migración. |
| Tienda con app mobile nativa | Alto. El pago se completa en un navegador, porque no hay un checkout dentro de la app. |
| Sitio de contenido, landing o micrositio con productos | Medio. Usa el catálogo y el checkout dentro de un sitio que no es la tienda. |
| Tienda que quiere un diseño personalizado y gestionarlo sin agencia | Bajo. Conviene el fork del diseño con Tiendanube CLI. |
| Tienda sin equipo técnico | Bajo. Conviene el diseño Ipanema con el Nuevo Editor. |
| Desarrollo de apps del ecosistema | Bajo. Conviene NubeSDK o la API Admin. |
Tampoco conviene si lanzar rápido es la prioridad. Un diseño puede estar en línea en días, mientras que un proyecto headless suele llevar semanas o meses, según el alcance. Si falta una sola funcionalidad, conviene extender el diseño con código, NubeSDK o App Proxy antes de reescribir el frontend.
¿Cómo solicito la habilitación de la Storefront API para una tienda?
La habilitación se gestiona de forma manual, tienda por tienda. Para solicitarla, escríbenos con estos datos:
- El link de la tienda que quieres habilitar.
- Un contacto técnico, con nombre y correo electrónico del desarrollador o de la agencia.
- Una breve descripción del proyecto, por ejemplo un sitio web propio, una app mobile o una migración desde otra plataforma.
Con esos datos, derivamos la solicitud al equipo correspondiente, que se comunica para continuar. Si consumes la API desde un servidor, el token también se gestiona de forma manual.
Para personalizar una tienda sin desarrollar un frontend, puedes personalizarla con el diseño Ipanema.