HILLS API
Conecta tus sistemas con HILLS Music: lee tu catálogo, tus entregas y tus ingresos, entrega lanzamientos en DDEX, recibe webhooks y conecta la IA por MCP.
Actualizado el
La HILLS API conecta tus propios sistemas con la plataforma de HILLS Music. Sellos, distribuidoras y titulares de catálogo la usan para leer los datos de su catálogo, de sus entregas y de sus regalías, y para entregar lanzamientos, sin depender solo del navegador.
La API ya está disponible. Se incluye en los planes Enterprise y Custom. Consulta Acceso y planes.
Qué puedes crear
- Sincronización del catálogo. Lee cada lanzamiento con sus pistas, su estado de revisión y su estado en cada plataforma. Usa
updated_sincepara sincronizar solo lo que ha cambiado. - Entrega de lanzamientos por DDEX. Envía lotes ERN (se recomienda 4.3) por la API o por SFTP. Cada lanzamiento se convierte en un borrador de tu catálogo y pasa por la revisión y la entrega a las plataformas. Prueba antes el lote: no se crea nada.
- Seguimiento de entregas. Sigue cada lanzamiento plataforma por plataforma y recibe un webhook cuando se aprueba, se publica o necesita una corrección.
- Informes. Lleva a tu BI o a tus herramientas de contabilidad los ingresos por mes, lanzamiento o plataforma, tu saldo y tus pagos, y las estadísticas de tus smart links.
- Alta de artistas. Consulta tus artistas y sellos e invita a otros nuevos.
- Asistentes de IA. Conecta Claude, ChatGPT y otros asistentes a tu espacio de trabajo mediante el servidor MCP.
Los lanzamientos solo entran en HILLS como DDEX ERN o a través de la aplicación web. La API no crea ni edita lanzamientos campo a campo, y no tiene una subida aparte para el audio o la portada: los archivos viajan dentro del lote DDEX.
Las piezas
| API REST | https://api.hillsmusic.com/v1, JSON sobre HTTPS, claves de API Bearer. Empieza por el inicio rápido. |
| DDEX | POST /ddex/validate para probar; POST /ddex y las subidas directas para entregar; además, SFTP con las carpetas /test y /production. Consulta Entrega DDEX. |
| Webhooks | Eventos firmados de lanzamientos, entregas a plataformas, DDEX, liquidaciones, pagos, solicitudes y soporte en vivo. Consulta Webhooks. |
| Servidor MCP | https://mcp.hillsmusic.com, 10 herramientas de solo lectura, inicio de sesión OAuth 2.1 con tu cuenta de HILLS. Consulta Servidor MCP. |
Cómo funciona el acceso
Hay un solo tipo de clave de API: hm_live_…. El propietario de la cuenta, o un miembro del equipo con el permiso de claves de API, crea las claves en la página Developers de la aplicación web de HILLS. Cada clave tiene sus propios ámbitos y una caducidad opcional.
No hay un sandbox aparte. Para probar una entrega DDEX, usa la misma clave con POST /ddex/validate o la carpeta SFTP /test. Las dos ejecutan todas las comprobaciones y no crean nada. Consulta Carpeta de pruebas.
Siguientes pasos
- Inicio rápido: crea una clave y haz tus primeras llamadas.
- Acceso y planes: quién puede usar la API y sus límites.
- Referencia de la API: todos los endpoints.