COMMON QUESTIONS
Frequently Asked Questions
Which stores does LabelGrid show streaming analytics for?
Ten stores send analytics feeds that we ingest and chart: Spotify, Apple Music, Amazon Music, Deezer, Audiomack, Boomplay, AWA, KuGou, KuWo, QQ Music. LabelGrid distributes to all major DSPs, so your catalog reaches further than that list. Stores without an analytics feed still pay out and still appear in your royalty statements. Statements and analytics run on separate pipelines.
Can I ask an AI assistant like Claude about my music streaming stats?
Yes. LabelGrid publishes the official MCP server, open source under the MIT licence and installed from npm as @labelgrid/mcp, so Claude Desktop, Claude Code, Cursor or any other Model Context Protocol client can answer questions about your own catalog in plain language. It wraps the same public analytics API, which means the assistant sees the same availability matrix and freshness dates the dashboard does and can say a store does not report something rather than inventing it. It runs on an API plan.
Does LabelGrid include Apple Music analytics and audience demographics?
Yes. Apple Music reports streams and listeners, streams broken down by age and gender, and its own city and storefront breakdowns. It also reports Shazam counts, including Shazams by city and state, library adds, editorial playlist adds, and discovery cohorts that measure how much of a window's audience is hearing a track for the first time. Spotify adds listener-level demographics covering age and gender. It also splits them by region and by the free-versus-paid plan mix. City and Shazam geography appear only once the audience reaches a minimum size, so a small catalog can show strong streams next to an empty city chart.
Can I see Spotify, Apple Music and Amazon Music stats in the same dashboard?
Yes. Combined mode totals the catalog across every store at once, compare mode puts them side by side, and single mode isolates one. Compare-all automatically includes any store whose feed we add later, which is how Amazon Music appeared in existing comparisons when it joined in August 2026. An existing comparison never goes stale because nobody remembered to tick a new box.
Why is a city or demographics chart empty when my streams look healthy?
Demographic and geographic breakdowns are k-anonymised. Any cell whose audience falls below the minimum floor is dropped outright rather than rounded or bucketed, and that covers Apple city breakdowns, Shazams by city and state, and listener demographics. No total is published that would let the suppressed audience be inferred. A small catalog can legitimately show strong streams alongside an empty city chart, and we never fabricate a number to fill the gap.
Why is a metric marked unavailable, or a chart empty, for one store?
Either the store does not report that metric at all, or your audience in that cell sits below the privacy floor. AWA reports streams only, and Amazon Music adds listeners and a country split. KuGou, KuWo and QQ Music report on a weekly cadence, so their charts show one point per week rather than a continuous line. An unavailable marker means the data does not exist on that feed, which is not the same thing as a zero.
How fresh is the data, and how far back does it go?
Every metric carries its own reported-through date and complete-through date, and stores publish on different lags, so one metric can be current through a later date than another. Days between the two are still filling and are marked partial rather than drawn as a drop. Spotify and Apple Music history reaches back years; the stores added in the July 2026 wave carry history from roughly late January 2026.
Is there an API to query my streaming stats programmatically?
Yes, on an API plan. It all sits under /api/public/analytics, scoped to your labels: summary and per-metric series calls, leaderboards, placements, an availability endpoint. One summary call takes up to twelve of the forty-seven sections, over a window as long as 400 days. Per-section freshness comes with it. The availability endpoint is parameter-less and cacheable, so your integration reads which store reports which metric instead of hardcoding it.
Does LabelGrid track Instagram and Snapchat use of my catalog?
The social view covers SoundCloud and Snapchat, and the Meta apps: Instagram, Facebook, WhatsApp, Messenger, Threads. Each reports what its feed provides: plays, reposts, favorites, playlist adds and average listen time for SoundCloud; content creates by territory, plus views, for Snapchat, Instagram, Facebook, WhatsApp, Messenger; views and reach for Threads; plus follower and engagement growth on Instagram and Facebook. All eight social sections are on the public API as well as the dashboard, and a social view never mixes into a DSP stream total.



