Visión general de la API y guía rápida

Actualizado en julio de 2026.

Sí — LabelGrid ofrece una API pública REST para la distribución programática. Permite a los desarrolladores leer su catálogo, crear y actualizar lanzamientos, subir recursos y enviar lanzamientos a distribución, y da soporte a los servicios de marca blanca construidos sobre LabelGrid. Esta guía es la introducción rápida; la referencia completa de endpoints está en api.labelgrid.com/docs/api.

La guía rápida de un vistazo

Paso	Qué hace usted
1. Activar un plan de API	El acceso a la API y al sandbox requiere un plan de API activo y de pago (facturado anualmente).
2. Generar un token de API	Abra el menú del avatar (arriba a la derecha) y haga clic en Tokens de API para crear un Bearer token.
3. (Opcional) Lista blanca de IP	Restrinja el uso del token a IP conocidas en la misma área de Tokens de API.
4. Leer la referencia	Explore los endpoints y las herramientas de «pruébalo» en api.labelgrid.com/docs/api.
5. Desarrollar contra el sandbox	Solicite un sandbox a soporte y pruebe sin tocar producción.
6. Pasar a producción	Apunte su integración a `api.labelgrid.com` y cree su primer lanzamiento.

Qué ofrece la API

La API pública está montada bajo /api/public/... en api.labelgrid.com y proporciona acceso programático a:

Lanzamientos: listar, crear, actualizar, eliminar; subir portadas; validar; enviar a distribución
Pistas: listar, crear, actualizar; subir archivos de audio; gestionar licencias de pistas
Sellos: listar y gestionar sus perfiles de sello
Artistas: listar y gestionar perfiles de artista
Autores y colaboradores: listar y gestionar perfiles de autor/colaborador
Editores: listar y gestionar perfiles de editor
Webhooks: registrar endpoints de webhook para notificaciones asíncronas
Analytics: datos de streams, listeners e interacción por día, plataforma, país y track; vea Filtros de alcance y datos por track y Plataformas, disponibilidad y límites
Datos de referencia: géneros, idiomas, roles de colaboradores, instrumentos, territorios de distribución, outlets de distribución

Casos de uso habituales

Automatizar la creación de lanzamientos desde sus sistemas existentes
Sincronizar los datos del catálogo con su base de datos
Crear paneles e informes a medida
Integrar con sus herramientas de flujo de trabajo existentes
Impulsar servicios de distribución de marca blanca sobre LabelGrid

Cómo obtener acceso a la API

Para usar la API de LabelGrid, necesita:

Un plan de API activo y de pago: el acceso a la API y al sandbox requiere un plan de API de pago. La prueba gratuita de 7 días que viene con los planes estándar no incluye acceso a la API ni al sandbox, y los planes de API se facturan de inmediato (sin período de prueba).
Un token de API generado desde los ajustes de su cuenta: abra el menú del avatar en la esquina superior derecha y haga clic en Tokens de API (solo visible si el acceso a la API está habilitado)
(Opcional) Lista blanca de IP para mayor seguridad: configúrela en la misma área

Si no ve la opción Tokens de API en su cuenta, contacte con soporte para hablar de habilitar el acceso a la API en su plan.

Autenticación

Todas las solicitudes a la API deben incluir un Bearer token en la cabecera Authorization:

Authorization: Bearer YOUR_API_TOKEN

Documentación de la API

Para la referencia completa de endpoints, los esquemas de solicitud/respuesta y las herramientas en vivo de «pruébalo», consulte la documentación autogenerada:

Producción: https://api.labelgrid.com/docs/api
Sandbox: https://api-sandbox.stg.labelgrid.com/docs/api

La documentación incluye:

Una guía de autenticación
Todos los endpoints disponibles con ejemplos de solicitud y respuesta
Información sobre limitación de velocidad (rate limiting)
La configuración de webhooks

Sandbox

LabelGrid ofrece un entorno de sandbox para que pueda desarrollar y probar contra la API sin afectar a su catálogo de producción. El acceso al sandbox requiere un plan de API activo y lo aprovisionamos nosotros a petición: una vez activo su plan de API, contacte con soporte para configurarlo. Nosotros configuramos por usted la lista blanca de IP del sandbox; la lista blanca de IP de producción es de autoservicio en Tokens de API.

Webhooks

La API pública admite webhooks para la notificación asíncrona de eventos (cambios de estado de revisión, actualizaciones de entrega, etc.). Consulte Webhooks para la configuración y los tipos de evento disponibles.

Preguntas frecuentes

«¿Tiene LabelGrid una API pública?»

Sí — LabelGrid ofrece una API pública REST para la distribución programática, montada bajo /api/public/... en api.labelgrid.com. Puede leer su catálogo, crear y actualizar lanzamientos, subir audio y portadas, gestionar artistas y colaboradores, registrar webhooks y enviar lanzamientos a distribución. La documentación completa está en api.labelgrid.com/docs/api.

«¿Cómo obtengo acceso a la API?»

El acceso a la API y al sandbox requiere un plan de API activo y de pago. Una vez activo su plan de API, genere un token de API desde los ajustes de su cuenta en Tokens de API (en el menú del avatar, arriba a la derecha). Si no ve esa opción, contacte con soporte para habilitar el acceso a la API. La prueba gratuita de 7 días de los planes estándar no incluye acceso a la API.

«¿Cómo autentico las solicitudes a la API?»

Incluya un Bearer token en la cabecera Authorization de cada solicitud: Authorization: Bearer YOUR_API_TOKEN. Genere el token en Tokens de API dentro de los ajustes de su cuenta y, opcionalmente, restrínjalo mediante lista blanca de IP.

«¿Hay un entorno de sandbox para pruebas?»

Sí. LabelGrid ofrece un sandbox para que pueda desarrollar y probar contra la API sin afectar a su catálogo de producción. El acceso al sandbox requiere un plan de API activo y se aprovisiona a petición — contacte con soporte una vez activo su plan de API. La documentación del sandbox está en api-sandbox.stg.labelgrid.com/docs/api.

«¿Cuánto cuesta la API de LabelGrid?»

La API está disponible en los planes de API de LabelGrid, que se facturan anualmente. Los planes empiezan por el nivel Starter API, con niveles superiores para catálogos más grandes y límites de procesamiento de royalties más altos. Consulte la página de precios para conocer los precios actuales y los detalles de cada nivel.

Relacionado

¿Está desarrollando sobre la API de LabelGrid? Consulte el hub para desarrolladores para una visión general de lo que es posible. Si está impulsando un servicio de distribución de marca blanca sobre LabelGrid, la página infraestructura para distribuidores cubre el panorama general. Vea también la guía Configuración de distribución de marca blanca.

¿Necesita ayuda?

Si necesita asistencia con la API, contacte con nuestro equipo de soporte con los detalles técnicos de su integración.

¿Aún no usas LabelGrid?

Todo lo que acabas de leer está disponible en nuestra plataforma.

Descubre lo que LabelGrid puede hacer →