Soundlink listening insights
What listeners who connected through this soundlink went on to play.
The date window comes from the listening graph (nodes_smart_link).
startDate and endDate are not accepted. Extra query parameters are ignored.
This request often takes 30–50 seconds. Use a client timeout of at least 120 seconds.
The Send button on this page stops around 30 seconds. The API keeps running and can still return 200.
If the API Gateway deadline elapses, the response is 504. That body is the gateway error, not the Public API envelope.
other-artists— other artists these listeners streamed, excluding attributed tracks and campaign artists. Top 30.catalog-dig-in— playlist reach and catalog follow-through per artist. Track soundlinks may returnartists: [].stream-split—tracksoundlinks return attributed contexts such aspromotedandartist_catalog.playlistsoundlinks returnplaylistthenartist_catalog. A context is omitted when listeners and streams are both 0. Any other campaign type returns200withcontexts: [].
Requires the soundlinks:read scope. Accepts API key or OAuth Bearer.
A soundlink created for a campaign is allowed here when the organization owns it,
even though GET /v1/soundlinks/{soundlinkId} does not return campaign soundlinks.
An unknown soundlink, or one owned by another organization, returns 404 not_found.
An owned soundlink with no listening-graph row returns 404 not_in_listening_graph
(Soundlink not available in listening graph).
Authorizations
Pass your Soundlink sk_* API key as a Bearer token:
Authorization: Bearer sk_<prefix>_<token> (not an OAuth token; see
oauthBearer for that). Accepted on all Public API operations. Send
only one Authorization header per request.
Path Parameters
Soundlink identifier (URL-safe string, same ID used in the public sndl.ink URL)
other-artists — what else these listeners stream.
catalog-dig-in — playlist artists and catalog follow-through.
stream-split — promoted, playlist, and artist-catalog split.
other-artists, catalog-dig-in, stream-split