What is the Music Analytics API?
The Music Analytics API is a flexible querying tool that produces aggregated, anonymized counts of listeners and plays across several dimensions obtained via the GET and POST functions within an endpoint. Learn more about this tool by reviewing the Music Analytics API Guide.
Who qualifies for access to the Music Analytics API?
Labels with more than 250,000 plays per month will have access to the tool. If your label has more than 250,000 plays per month and you do not have the Keys feature within iTunes Connect Users and Access, contact us.
Should everyone in my organization get access to the Music Analytics API?
The Music Analytics API is a technical tool. Assign users with knowledge of scripting and writing JSON queries.
What should I do if a user loses their private key file?
If a user loses their private key file, take the following steps in iTunes Connect to revoke their access and add them as a new user:
- Go to Users and Access.
- Click Keys.
- Select the intended user and click Revoke.
- A warning message will appear asking you to confirm the action. Click Revoke and add them as a new user again.
Once a user gets revoked, they are removed from the Active list and will appear in the Revoke list.
NOTE: Revoked keys are only displayed for 30 days.
Will removing a user’s access to the Music Analytics API impact their access to iTunes Connect or Sales and Trends?
No. The new Keys feature within iTunes Connect only applies to the Music Analytics API.
How long does an access token remain active?
Access tokens last 20 minutes. For continuous processes, we recommend renewing the token every 18 minutes and using the current token to optimize performance.
How does the Music Analytics API protect listeners’ privacy?
The Apple-hosted solution will only return counts of listeners and plays after meeting a minimum threshold. Data is also rounded to the nearest 50th value (127,987 displays as 128,000) to balance providing insights and protecting the listeners' privacy.
What data is accessible?
Use your Issuer ID to query content. You will only be able to see the content that you deliver to Apple Music.
How is the data structured?
Are there rate limits?
There are no rate limits currently, though it’s likely there will be in the future. Be mindful that your queries could impact other users in the same organization. There are, however, limits on how much content can fit within each query. Queries are limited to 100 Song IDs, 10 Album IDs, and 5 Artist IDs.
What is the earliest date period available?
The earliest query date is when your label’s content became available on Apple Music. In many cases, that earliest date is when Apple Music launched on June 30, 2015.
What is the most granular time period I can query?
The most granular period is within a full day. Results are displayed in UTC format by default and can be modified to other time zones (for example, EST, CST, PST). Results will be based on the time zone selected.
Is it possible to treat multiple IDs as one entry?
When providers search for multiple IDs, the Music Analytics API will default the results to a single value, and counts will be attributed once.
Can I filter or group by dimensions?
Each endpoint offers the ability to filter and group by various dimensions. There’s no limit on how many can be applied, but note two things:
- Adding more filters or “group by” options will take the query more time to return results.
- The privacy threshold must still be met before displaying results. Applying more filters or groups by dimensions may mean this threshold is not hit.
Can I treat multiple IDs as separate entries?
When querying content by multiple IDs, you can apply a "group_by" function. Instead of querying one-by-one, the "group_by" function takes each ID and aggregates every listen as if it were one Apple ID.
Who should I reach out to with questions or help?
If you have any questions about accessing or using the Music Analytics API, contact us.