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

# Spotify Ads

> Connect Spotify Ads as a data source for automated campaign performance reports — impressions, clicks & spend

<Info>
  **Paid Feature** — Spotify Ads is available on all paid plans (Starter, Pro, Enterprise). [See pricing](https://chartcastr.com/pricing).
</Info>

## Overview

Use Spotify Ads as a data source for Chartcastr. Connect via OAuth and pull daily impressions, clicks, and spend across your Spotify Ads Manager campaigns. Chartcastr delivers these metrics as charts to Slack or email on your schedule.

Chartcastr connects with read-only scopes — we never modify campaigns, audiences, or budgets.

## Setup

<Steps>
  <Step title="Connect your Spotify account">
    In Chartcastr, go to [Sources](https://chartcastr.com/admin/sources) and select **Spotify Ads**. Click **Connect** and complete the OAuth flow.
  </Step>

  <Step title="Pick an ad account">
    If your Spotify login owns multiple Ads Manager accounts, select the one you want to chart.
  </Step>

  <Step title="Choose a metric">
    Pick from Ad Impressions, Ad Clicks, or Ad Spend — each tracks daily values over the trailing 30-day window.
  </Step>

  <Step title="Schedule the chart">
    Go to [Connections](https://chartcastr.com/admin/connections) → **New Connection**. Select your Spotify Ads source, pick a destination (Slack channel or email), set the frequency, and optionally enable AI summaries.
  </Step>
</Steps>

## Available Charts

<Card title="View all available charts" icon="list" href="/integrations/sources/spotify/available-charts">
  See the full list of Spotify Ads metrics with chart types and descriptions.
</Card>

## Data & Permissions

Chartcastr requests the following Spotify OAuth scopes (all read-only):

| Scope               | Purpose                                            |
| ------------------- | -------------------------------------------------- |
| `user-read-private` | Identify the connected Spotify user                |
| `user-read-email`   | Display the user's email in the connection details |

The Ads API uses the same OAuth token — access is determined at runtime by whether your Spotify account owns an Ads Manager account.

### What data does Chartcastr access?

* **Ads reporting**: Daily impressions, clicks, and spend per ad account. We do not read individual creatives, audiences, or budgets.

Chartcastr does **not** modify your Spotify library, follows, playlists, or any campaign settings.

## Next Steps

<CardGroup cols={2}>
  <Card title="Slack destination" icon="slack" href="/integrations/destinations/slack">
    Deliver Spotify Ads charts to your Slack channels with AI summaries in the thread.
  </Card>

  <Card title="Email destination" icon="envelope" href="/integrations/destinations/email">
    Schedule Spotify Ads reports to any inbox or distribution list.
  </Card>
</CardGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Why don't I see any Ads metrics?">
    Ads metrics only appear when the connected Spotify account has at least one ad account in Spotify Ads Manager. Make sure you're connecting with an account that has Ads access.
  </Accordion>

  <Accordion title="Can I get monthly listeners or stream counts for an artist?">
    Not via the Spotify integration. Detailed artist analytics (monthly listeners, daily streams, save rate, audience demographics) require Spotify's partner APIs (reserved for labels and distributors). For cross-platform artist analytics, check out the **Chartmetric** integration which aggregates data from 20+ platforms.
  </Accordion>

  <Accordion title="How often is data refreshed?">
    Data is fetched fresh from Spotify every time a pulse fires. Chartcastr does not cache or store your ads data between runs.
  </Accordion>

  <Accordion title="What date range is used for Ads charts?">
    Spotify Ads charts default to a trailing 30-day window with daily granularity.
  </Accordion>
</AccordionGroup>