Data sources

Demo mode: no provider below is feeding the charts you are looking at. Every chart on this deployment is generated from clearly fictional fixtures by the real JAWNRA engine.

• Chartmetric

  aggregator · phase 3

  Planned · awaiting credentials

  Paid plan (prepaid credits or fixed-rate). Bearer JWT from /api/token using a refresh token. Confirm redistribution/display rights for each underlying source (Spotify, Shazam, TikTok…) in the contract before publishing derived charts.

  streamsshazamsplaylist reachplaylist addssocial createsvideo viewsaudiencecountry chartscity chartsgenre chartsidentity

• Apple Music API

  streaming · phase 3

  Planned · awaiting credentials

  Requires Apple Developer Program membership and a MusicKit key. Catalog charts (GET /v1/catalog/{storefront}/charts) are most-played rankings, not counts, and are used as an ordinal signal only.

  country chartsgenre chartsidentityartworkpreviews

• Spotify Web API

  streaming · phase 4

  Planned · awaiting credentials

  Used for track resolution and user-authorised playlist saving only. Popularity, follower counts, top-tracks and several catalog endpoints were removed (Feb 2026). Development Mode is capped at 5 users and requires the app owner to hold Premium. Spotify content must not be used to train ML/AI models.

  identityartwork

• Last.fm

  discovery · phase 3

  Planned · awaiting credentials

  Commercial use requires a separate commercial agreement with Last.fm. Must cache per HTTP headers, credit Last.fm with links, and respect a 100MB storage cap without consent. Keep disabled in production until an agreement exists.

  streamscountry chartsaudience

• MusicBrainz

  metadata · phase 3

  Planned · awaiting credentials

  Core data is CC0. Max ~1 request/second per client and a descriptive User-Agent with contact info are required.

  identity

• YouTube Data API

  social · phase 3

  Not in use

  Quota-based. Subject to YouTube API Services Terms and Developer Policies (data refresh/deletion rules apply to stored statistics).

  video viewsidentity

• Deezer API

  streaming · phase 4

  Not in use

  Free API with rate limits; higher limits only via a commercial agreement. New-app availability should be confirmed on the Deezer developer portal before building the write flow.

  identitypreviewscountry charts

• TIDAL API

  streaming · phase 4

  Not in use

  Catalog read via the v2 API. Public playlist-write support has been requested by developers but must be confirmed in the current API reference before JAWNRA offers ‘Save to TIDAL’.

  identity

• Beatport

  store · phase 3

  Not in use

  No self-serve public API assumed. Electronic subgenre chart data only via a licensed route (e.g. an aggregator) or partnership.

  genre charts

• SoundCloud

  discovery · phase 3

  Not in use

  API access is application-gated. Use only once approved and within its terms.

  streamsidentity

• Editorial feeds (RSS)

  editorial · phase 3

  Credentials present · demo mode

  Only public RSS/Atom feeds, official APIs, or licensed data. Each outlet is individually approved in config/editorial.ts. No scraping.

  editorial mentions

• TikTok

  social · phase 3

  Not in use

  TikTok's Research API is not available for commercial products. Social creation counts only via a licensed commercial data partner.

  social creates