Ingresos
Ingresos de las liquidaciones confirmadas de las plataformas por mes, lanzamiento o plataforma, con la parte de tus artistas.
Ingresos de las liquidaciones confirmadas de las plataformas por mes, lanzamiento o plataforma, con la parte de tus artistas.
URL base https://api.hillsmusic.com/v1. Cada solicitud envía una clave de API: Authorization: Bearer hm_live_….
- Ingresos
Ingresos
GET /v1/earnings · Ámbito: earnings:read
Ingresos de las liquidaciones confirmadas de las plataformas, en USD. amount_usd es tu total; member_share_usd es la parte que tus repartos de ingresos asignan a tus artistas y sellos.
Parámetros
| Parámetro | Ubicación | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
by |
query | month | release | store |
No | Cómo agrupar (predeterminado: month). |
months |
query | integer (1–60) | No | Cuántos meses hacia atrás (predeterminado: 12). |
Ejemplo de solicitud
curl "https://api.hillsmusic.com/v1/earnings?by=store&months=6" \
-H "Authorization: Bearer $HILLS_API_KEY"Respuesta 200
{
"by": "store",
"months": 6,
"currency": "USD",
"data": [
{
"key": "Spotify",
"label": "Spotify",
"amount_usd": 1520.42,
"member_share_usd": 1064.29,
"units": 412003
}
]
}Errores
| Estado | Cuándo |
|---|---|
| 400 | invalid: un parámetro es incorrecto; field indica cuál. |
| 401 | unauthenticated, invalid_key, key_revoked, key_expired o test_keys_retired. |
| 403 | insufficient_scope: a la clave le falta el ámbito; scope indica cuál. account_inactive o api_not_in_plan. |
| 429 | rate_limited: espera los segundos que indique Retry-After. |