Erlöse
Erlöse aus verbuchten Store-Abrechnungen nach Monat, Release oder Store, mit dem Anteil Ihrer Artists.
Erlöse aus verbuchten Store-Abrechnungen nach Monat, Release oder Store, mit dem Anteil Ihrer Artists.
Basis-URL https://api.hillsmusic.com/v1. Jede Anfrage sendet einen API-Schlüssel: Authorization: Bearer hm_live_….
- Erlöse
Erlöse
GET /v1/earnings · Scope: earnings:read
Erlöse aus verbuchten Store-Abrechnungen in USD. amount_usd ist Ihre Gesamtsumme; member_share_usd ist der Teil, den Ihre Erlös-Splits Ihren Artists und Labels zuweisen.
Parameter
| Parameter | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
by |
query | month | release | store |
Nein | Gruppierung (Standard month). |
months |
query | integer (1–60) | Nein | Wie viele Monate zurück (Standard 12). |
Beispielanfrage
curl "https://api.hillsmusic.com/v1/earnings?by=store&months=6" \
-H "Authorization: Bearer $HILLS_API_KEY"Antwort 200
{
"by": "store",
"months": 6,
"currency": "USD",
"data": [
{
"key": "Spotify",
"label": "Spotify",
"amount_usd": 1520.42,
"member_share_usd": 1064.29,
"units": 412003
}
]
}Fehler
| Status | Wann |
|---|---|
| 400 | invalid: Ein Parameter ist fehlerhaft; field nennt ihn. |
| 401 | unauthenticated, invalid_key, key_revoked, key_expired oder test_keys_retired. |
| 403 | insufficient_scope: Dem Schlüssel fehlt der Scope; scope nennt ihn. account_inactive oder api_not_in_plan. |
| 429 | rate_limited: Retry-After Sekunden warten. |