> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Spotify Third Party Connector

## Intro

Spotify is a digital music distribution service that offers tens of millions of songs.

Domo's Spotify connector allows you to use Spotify's Bulk API to import performance data provided by Spotify For Artists into your Domo instance. This performance data includes users, tracks, and streams tied to licensors.

You connect to your Spotify account in the Data Center. This topic discusses the fields and menus that are specific to the Spotify Connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](/s/article/360042926274).

## Prerequisites

To connect to your Spotify account and create a DataSet, you must have the following:

* Client ID
* Client Secret

The Spotify Connector uses Spotify’s Bulk API. To use the API, you must have a direct distribution relationship with Spotify. Also, you need to request to use the API to Spotify.

For details, see [Help - Getting access to Spotify's Bulk API – Spotify for Artists](https://artists.spotify.com/help/article/getting-access-to-bulk-api). After your request is approved, you can get the Client ID and the Client Secret.

## Connecting to your Spotify Account

This section enumerates the options in the **Credentials** and **Details** panes in the Spotify Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

### Credentials Pane

This pane contains fields for entering credentials to connect to your Spotify account. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"> Field </span></p></th><th colspan="1" rowspan="1"><p><span class="s1"> Description </span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Client ID </p></td><td colspan="1" rowspan="1"><p> Enter your Client ID published by Spotify. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Client Secret </p></td><td colspan="1" rowspan="1"><p> Enter your Client Secret published by Spotify </p></td></tr></tbody></table>

For information about obtaining these credentials, see **Prerequisites** above.

After you have entered valid Spotify credentials, you can use the same account any time you go to create a new Spotify DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](/s/article/360042926054 "Managing User Accounts for Connectors").

### Details Pane

This pane contains a primary **Reports** menu, along with various other menus which may or may not appear depending on the report type you select.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"> Report </td><td colspan="1" rowspan="1"> Select the reports you want to run. The following reports are available: <table border="1" cellpadding="1" cellspacing="1"><thead /><tbody><tr><td colspan="1" rowspan="1"> Streams </td><td colspan="1" rowspan="1"> This report contains individual stream objects with track and user information for a given licensor, date, and country. Only actual streams are included; plays from local tracks (stored on the user's computer) are not counted. </td></tr><tr><td colspan="1" rowspan="1"> Users </td><td colspan="1" rowspan="1"> This report contains individual users objects with personal and device-related information for a given licensor and date. </td></tr><tr><td colspan="1" rowspan="1"> Track </td><td colspan="1" rowspan="1"> This report contains individual track objects with more detailed track-level information for a given licensor and date. </td></tr><tr><td colspan="1" rowspan="1"> Sub30SecStreams </td><td colspan="1" rowspan="1"> This report contains individual stream objects (only including streams lasting less than 30s) for a given licensor, date and country. Only actual streams are included; plays from local tracks (stored on the user's computer) are not counted. </td></tr><tr><td colspan="1" rowspan="1"> Aggregated Stream – Summary </td><td colspan="1" rowspan="1"> This report contains individual track-based aggregated stream objects with metadata and demographic data for a given licensor and date. Only actual streams are included; plays from local tracks (stored on the user's computer) are not counted. </td></tr><tr><td colspan="1" rowspan="1"> Aggregated Stream – Count </td><td colspan="1" rowspan="1"> This report contains individual track-based aggregated stream objects with play count for each country, gender and age for a given licensor and date. Only actual streams are included; plays from local tracks (stored on the user's computer) are not counted. </td></tr><tr><td colspan="1" rowspan="1"> Aggregated Stream – Skips </td><td colspan="1" rowspan="1"> This report contains individual track-based aggregated stream objects with skip count for each country for a given licensor and date. Only actual streams are included; plays from local tracks (stored on the user's computer) are not counted. </td></tr><tr><td colspan="1" rowspan="1"> Aggregated Stream – Saves </td><td colspan="1" rowspan="1"> This report contains individual track-based aggregated stream objects with save count for each country and user’s plan for a given licensor and date. Only actual streams are included; plays from local tracks (stored on the user's computer) are not counted. </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Licensore </p></td><td colspan="1" rowspan="1"><p> Enter the Licensor name. <br /> Check your welcome email to locate the licensor name that Spotify has on file. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Date </p></td><td colspan="1" rowspan="1"><p> In the <b> Date </b> selection, select whether to use a single day or a date range when filtering the results by item update date. </p><table border="1" cellpadding="1" cellspacing="1"><thead /><tbody><tr><td colspan="1" rowspan="1"> Single date </td><td colspan="1" rowspan="1"> Select the specific or relative single date. </td></tr><tr><td colspan="1" rowspan="1"> Date range </td><td colspan="1" rowspan="1"> Select the specific or relative date range. </td></tr><tr><td colspan="1" rowspan="1"> Time period </td><td colspan="1" rowspan="1"> Select the time period from Time period dropdown for your report. </td></tr></tbody></table></td></tr><tr /><tr><td colspan="1" rowspan="1"><p> Date – Date </p></td><td colspan="1" rowspan="1"><p> Select in <b> Date Type </b> from the followings whether the report data is for a specific date or for a relative number of days back from today: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"> Relative </td><td colspan="1" rowspan="1"> Enter the number of days back that you would like to get data for in the <b> Days Back </b> field. Specify either today or 0, yesterday or 1, or today-7 or 7 to get data for 7 days into the past. </td></tr><tr><td colspan="1" rowspan="1"> Specific </td><td colspan="1" rowspan="1"> Select the specific date using the date selector in the <b> Date </b> field. </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"> Date – Start Date </td><td colspan="1" rowspan="1"><p> Select in <b> Date Type </b> from the followings: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"> Relative </td><td colspan="1" rowspan="1"> Enter the number of days back that you would like to get data from (start day). Combine with End Date to create a range of represented days. <br /> For example, if you entered 10 for <b> Start Date </b> and 5 for <b> End Date </b>, the report would contain data for 10 days ago up until 5 days ago. </td></tr><tr><td colspan="1" rowspan="1"> Specific </td><td colspan="1" rowspan="1"> Select the first date in your date range using the date selector. </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Date – End Date </p></td><td colspan="1" rowspan="1"><p> Select in <b> Date Type </b> from the followings: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"> Relative </td><td colspan="1" rowspan="1"> Enter the number of days back that you would like to get data to (end day). Combine with Start Date to create a range of represented days. <br /> For example, if you entered 10 for <b> Start Date </b> and 5 for <b> End Date </b>, the report would contain data for 10 days ago up until 5 days ago. </td></tr><tr><td colspan="1" rowspan="1"> Specific </td><td colspan="1" rowspan="1"> Select the last date in your date range using the date selector. </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Date – Time period </p></td><td colspan="1" rowspan="1"><p> Choose the time period for which you would like to receive data. </p></td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](/s/article/360042926274).

### FAQs

<AccordionGroup>
  <Accordion title="What is needed to use the connector?">
    The Spotify Connector uses Spotify’s Bulk API. To use the API, you must have a direct distribution relationship with Spotify. Also, you need to request to use the API to Spotify. For details, see [Help - Getting access to Spotify's Bulk API – Spotify for Artists](https://artists.spotify.com/help/article/getting-access-to-bulk-api).
  </Accordion>

  <Accordion title="Are there any API limits that I need to be aware of?">
    Currently there are no limits.
  </Accordion>
</AccordionGroup>
