Expose Repeat Listeners in the public API
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 4/5
- Temps estimé
- 3-5 jours
- Accessibilité débutants
- 40/100
- Type d'issue
- Fonctionnalité
- Clarté
- Clairement spécifiée
- Activité
- Active
- Domaine
- api, backend-api-design
Piste de recherche
Read the SoundCloud help article linked in the issue and the related issue #68 for the broader Insights API ask, plus the current documented track stats endpoints, to see where a repeat-listener field would fit. Scope is a documented OAuth-scoped analytics endpoint or track field with reporting period, update timestamp, and summed-vs-deduplicated semantics defined. Done looks like a written API proposal accepted by maintainers — note this repo is feedback-only, so no code change is available to a contributor.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Please expose the Repeat Listeners count through a documented public developer API that third-party developers can use to build artist dashboards. Access to the metric must require OAuth authorization from the artist and must be limited to that artist's own account and tracks; these analytics should not be publicly readable for other artists. This metric already exists in SoundCloud Artist Insights, but it is not exposed in the documented public API.
Artists want to build dashboards that aggregate repeat-listener counts across tracks, alongside plays and recommended plays, to compare audience retention and discovery without manually collecting figures from each track's Insights UI.
A documented analytics endpoint or track-statistics field should provide:
- Per-track repeat-listener counts, using the same definition as Artist Insights.
- A consistent reporting period and update timestamp so dashboards can compare metrics reliably.
- Availability to registered developer applications, with required artist OAuth authorization. Each application may retrieve analytics only for the authorizing artist's own tracks, respecting existing account entitlements.
Please also document whether cross-track totals represent summed per-track counts or deduplicated listeners. Aggregate counts would meet this use case; individual listener identities are not required.
SoundCloud documents the existing UI metric here: https://help.soundcloud.com/hc/en-us/articles/115003451227-Individual-Track-Insights
Related: #68 requests broader Insights API access. This request specifically asks for the existing Repeat Listeners metric to be available through the public API.
If public API access is not possible, please consider adding this as a built-in Artist Pro Insights feature: an account/profile-level dashboard that aggregates Repeat Listeners alongside plays and recommended plays across the artist's tracks. At minimum, let artists select a group of tracks and view the combined metrics for that selection, with clear labeling of summed per-track counts versus deduplicated listeners.
- Langage dominant
- JavaScript
- Étoiles
- 260
- Forks
- 52
- Merge moyen
- 1 min
- PR mergées (30 j)
- 1
Préparer son environnement
Ce projet ne fournit ni conteneur de développement, ni Dockerfile, ni guide de contribution : l'installation est à votre charge. Commencez par son README, et consultez notre guide de la première contribution pour les étapes générales.
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de soundcloud/api
-
Difficulté 5/5 Plus d'une semaine Accessibilité débutants 25/100
soundcloud/api#605 ·
-
enhancement widget
Difficulté 4/5 3-5 jours Accessibilité débutants 45/100
soundcloud/api#603 · 1 commentaire ·
-
Difficulté 4/5 3-5 jours Accessibilité débutants 15/100
soundcloud/api#600 · 4 commentaires ·
-
enhancement
Difficulté 5/5 Plus d'une semaine Accessibilité débutants 25/100
soundcloud/api#597 · 1 réaction ·
-
question
Difficulté 4/5 3-5 jours Accessibilité débutants 45/100
soundcloud/api#595 · 4 commentaires ·
Toutes les issues de soundcloud/api
Issues similaires
-
Difficulté 1/5 Moins d'une heure Accessibilité débutants 85/100
521xueweihan/HelloGitHub#4115 ·
-
bug
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
outline/outline#14348 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 74/100
Les mainteneurs répondent en général sous 1 jour
-
area:install bug needs-triage
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
Les mainteneurs répondent en général sous 3 jours
-
Difficulté 2/5 1-3 heures Accessibilité débutants 75/100
Les mainteneurs répondent en général sous 1 jour