Campaign listening insights
What listeners who connected through this campaign 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 campaigns may returnartists: [].stream-split—trackcampaigns return attributed contexts such aspromotedandartist_catalog.playlistcampaigns returnplaylistthenartist_catalog. A context is omitted when listeners and streams are both 0. Any other campaign type returns200withcontexts: [].
Requires the metrics:read scope. Accepts API key or OAuth Bearer.
A campaign outside the organization returns 404 campaign_not_found.
An owned campaign 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
Campaign identifier (UUID)
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