> ## Documentation Index
> Fetch the complete documentation index at: https://www.getsoundlink.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Listening insights

> Which listening-insight endpoint to call, and how long to wait.

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`.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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`.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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](https://www.getsoundlink.com/docs/soundlinks.md) 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`.

## Next

[Campaign metrics](https://www.getsoundlink.com/docs/understanding-metrics.md) · [Soundlink metrics](https://www.getsoundlink.com/docs/soundlink-metrics.md) · [API Reference](https://www.getsoundlink.com/docs/api-reference)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.