Revenus
Les revenus issus des relevés de plateformes comptabilisés, par mois, par sortie ou par plateforme, avec la part de vos artistes.
Les revenus issus des relevés de plateformes comptabilisés, par mois, par sortie ou par plateforme, avec la part de vos artistes.
URL de base https://api.hillsmusic.com/v1. Chaque requête envoie une clé d’API : Authorization: Bearer hm_live_….
- Revenus
Revenus
GET /v1/earnings · Scope : earnings:read
Les revenus issus des relevés de plateformes comptabilisés, en USD. amount_usd est votre total ; member_share_usd est la part que vos répartitions de revenus attribuent à vos artistes et labels.
Paramètres
| Paramètre | Emplacement | Type | Obligatoire | Description |
|---|---|---|---|---|
by |
query | month | release | store |
Non | Critère de regroupement (month par défaut). |
months |
query | integer (1–60) | Non | Nombre de mois d’historique (12 par défaut). |
Exemple de requête
curl "https://api.hillsmusic.com/v1/earnings?by=store&months=6" \
-H "Authorization: Bearer $HILLS_API_KEY"Réponse 200
{
"by": "store",
"months": 6,
"currency": "USD",
"data": [
{
"key": "Spotify",
"label": "Spotify",
"amount_usd": 1520.42,
"member_share_usd": 1064.29,
"units": 412003
}
]
}Erreurs
| Statut | Quand |
|---|---|
| 400 | invalid : un paramètre est incorrect ; field l’indique. |
| 401 | unauthenticated, invalid_key, key_revoked, key_expired ou test_keys_retired. |
| 403 | insufficient_scope : la clé n’a pas le scope requis ; scope l’indique. account_inactive ou api_not_in_plan. |
| 429 | rate_limited : attendez le nombre de secondes indiqué par Retry-After. |