Platformbeschikbaarheid van statistieken (API)

Wanneer je streaming-analytics opvraagt via de openbare LabelGrid API en op één platform filtert, vertelt het antwoord je of dat platform de gevraagde statistiek daadwerkelijk rapporteert. Zo kan je integratie onderscheid maken tussen “nog geen gegevens” en “dit platform rapporteert deze statistiek nooit”.

Het veld availability

Voeg een platformfilter toe aan een willekeurig analytics-verzoek — bijvoorbeeld filter[platform]=SPOTIFY — en het antwoord bevat naast de gebruikelijke data een veld availability:

• available — het platform rapporteert deze statistiek; data wordt normaal gevuld.
• not_available_for_platform — het platform rapporteert deze statistiek niet. data wordt leeg teruggegeven. Dit is verwacht gedrag, geen fout.

Het veld availability verschijnt alleen wanneer je op één platform filtert. Verzoeken zonder platformfilter geven data precies zoals voorheen terug, zonder availability-sleutel.

De vorm van data blijft ongewijzigd — availability wordt ernaast toegevoegd, zodat bestaande integraties zonder aanpassing blijven werken.

Endpoints voor afzonderlijke statistieken

Elk afzonderlijk analytics-endpoint geeft naast zijn data één availability-waarde op het hoogste niveau terug:

{
  "availability": "not_available_for_platform",
  "data": []
}

Het analytics-summary-endpoint

Het endpoint /analytics/summary geeft meerdere secties tegelijk terug. Het bevat een parallelle availability-map met één item per sectie, zodat je kunt zien welke secties het platform rapporteert en welke leeg terugkomen:

{
  "availability": {
    "streams": "available",
    "listeners": "available",
    "streams_by_country": "available",
    "streams_by_gender": "available",
    "streams_by_age": "available",
    "saves": "not_available_for_platform"
  },
  "data": { }
}

Welk platform welke statistieken rapporteert

Platform (filter[platform])	Gerapporteerde statistieken
SPOTIFY	Alle analytics-statistieken
APPLE_MUSIC (ITUNES wordt ook geaccepteerd)	Streams, luisteraars, streams per land, streams per geslacht en streams per leeftijd

Voor Apple Music geeft elke statistiek buiten die lijst not_available_for_platform terug met lege data. Spotify rapporteert elke analytics-statistiek.

Hoe je dit in je integratie afhandelt

• Lees availability voordat je een lege data als “geen activiteit” behandelt. Een leeg resultaat met not_available_for_platform betekent dat het platform die statistiek helemaal niet rapporteert.
• Wanneer je meerdere statistieken tegelijk opvraagt via /analytics/summary, controleer dan voor elke sectie de bijbehorende sleutel in de availability-map.
• Als je niet op platform filtert, is er geen availability-veld — het antwoord is de gecombineerde weergave over alle platforms, precies zoals voorheen.

Gerelateerd

• API-overzicht — authenticatie, endpoints en de volledige referentie
• Analytics — het analytics-dashboard en wat elk tabblad toont