Listening insights

Listening insights answer three questions about people who connected Spotify through a campaign or soundlink. Pick the insight that matches the question. The response window is the one stored on the listening graph. Do not send startDate or endDate. These calls often take 30–50 seconds. Set the client timeout to at least 120 seconds. The Send button on the API reference stops around 30 seconds. The API keeps running and can still return 200. If the gateway deadline elapses, the response is 504. That body is the gateway error, not the { data, meta } envelope.

Question	`insight`	Path
What else do these listeners stream?	`other-artists`	Campaign or soundlink
Did playlist listeners go on to the artist’s catalog?	`catalog-dig-in`	Playlist campaigns and soundlinks. Track targets may return `artists: []`.
How do streams split across promoted, playlist, and catalog?	`stream-split`	`track` returns attributed contexts such as `promoted` and `artist_catalog`. `playlist` returns `playlist` then `artist_catalog`. Any other campaign type returns `200` with `contexts: []`.

A context row is left out when both listeners and streams are 0.

Campaign

Requires metrics:read.

curl -sS 'https://api.getsoundlink.com/v1/campaigns/CAMPAIGN_ID/listening-insights/other-artists' \
  -H 'Authorization: Bearer sk_YOUR_PREFIX_YOUR_SECRET' \
  --max-time 120

A campaign outside the organization returns 404 campaign_not_found. An owned campaign that is not in the listening graph returns 404 not_in_listening_graph.

Soundlink

Requires soundlinks:read.

curl -sS 'https://api.getsoundlink.com/v1/soundlinks/SOUNDLINK_ID/listening-insights/catalog-dig-in' \
  -H 'Authorization: Bearer sk_YOUR_PREFIX_YOUR_SECRET' \
  --max-time 120

A soundlink created for a campaign is allowed on this path when your organization owns it, even though list and detail hide campaign soundlinks. An unknown soundlink returns 404 not_found. An owned soundlink that is not in the listening graph returns 404 not_in_listening_graph.

Campaign metrics · Soundlink metrics · API Reference

Get started

AI tools

For Developers

Learn

Campaign

Soundlink

Next