Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Expose Fan Support contributions and per-supporter engagement in the public API

Đang mở
  • Có gì không ổn?
#597 0 bình luận 1 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
25/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
javascript, openapi
Lĩnh vực
api

Hướng nghiên cứu

Start with the documented API definition in openapi/api.yaml and review the existing /me endpoints, then read related issues #596 and #68 for context. The issue proposes new contribution and supporter endpoints, per-supporter engagement, privacy constraints, or a UI fallback, but does not identify implementation entry points or settle the scope. Done would require an agreed approach that respects the stated privacy limits and documents the resulting API or UI.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

enhancement

Scope: this is only for my own tracks. Everything below, API or UI, covers only how fans engage with the authorizing artist's own tracks. Nothing about what fans listen to from other artists.

Please expose Fan Support data through a documented public developer API, so artists can build dashboards that connect fan contributions with listening behavior. Access must require OAuth authorization from the artist and must be limited to that artist's own account, own supporters, and own tracks. No data about other artists, and no listening activity on other artists' tracks.

Today Fan Support payments are only visible in the Fan Support Dashboard, and the documented API (openapi/api.yaml) has no endpoints or fields for contributions or supporters. Artists who want to understand and thank their supporters have to copy figures by hand.

Use case

An artist wants to see, per supporter:

  • How much they have contributed (total, count, first and most recent contribution).
  • How they engage with the artist's own catalog: plays, likes, reposts, comments.
  • Which of the artist's tracks they listen to most.

This lets artists find which tracks turn listeners into supporters, thank top supporters personally, and plan releases around what their supporters actually play.

Requested endpoints (artist's own account only)
  1. GET /me/fan-support/contributions: paginated list of contributions received, with amount, currency, timestamp, and supporter (user object, or an anonymous marker when the supporter chose not to be shown).
  2. GET /me/fan-support/supporters: paginated list of supporters with totals (sum, count, first and last contribution date). Ideally sortable by total, matching the public Top Supporters leaderboard.
  3. GET /me/fan-support/supporters/{user_id}/engagement: that supporter's engagement with the artist's own tracks only: play counts per track, likes, reposts, comments, over a stated reporting period.
Privacy
  • Only the authorizing artist can read their own supporters, and only engagement with that artist's own tracks.
  • Supporters who contributed anonymously, or who opted out of the leaderboard, should be returned without identity, or with aggregate engagement only.
  • If per-supporter listening history is not acceptable, an aggregate version would still cover most of the use case: total plays of each of the artist's tracks by their supporters as a group, versus all listeners.
Fallback: build it into the SoundCloud UI

If public API access is not possible, please build this into the SoundCloud UI instead, especially where artists message fans.

The main reason I want this is to start real conversations with supporters. When a fan supports me and I open a DM to thank them, I want to see which of my tracks they actually listen to, so I can open with something personal ("glad you've been playing X on repeat") instead of a generic thank-you. Right now there is no way to know that from the messaging screen or the Fan Support Dashboard.

Concretely:

  • In the DM / Messages screen: when messaging a fan, a small panel showing their top played tracks of mine, plus whether they've liked, reposted, or commented on my tracks, and their Fan Support history with me (total and most recent contribution).
  • In the Fan Support Dashboard: a per-supporter view with contribution history next to which of my tracks they play most, with a "Message" button that opens the DM with that panel, plus a CSV export.

Same privacy limits as above: only my own tracks, only fans who interact with me, anonymous supporters stay anonymous.

Related: #596 (Repeat Listeners, scoped to the artist's own tracks), #68 (broader Insights API access).

SoundCloud documents Fan Support here: https://help.soundcloud.com/hc/en-us/articles/45965135036443-Fan-Support

Ngôn ngữ chính
JavaScript
Star
256
Fork
53
Merge trung bình
1 phút
Pull request đã merge (30 ngày)
1

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của soundcloud/api

Tất cả issue của soundcloud/api

Issue tương tự

Thêm issue về JavaScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.