Napster API
★ Only Publicly Available OpenAPI DocumentMediaAudio ProcessingapiKey, oauth227 EndpointsREST
For Agents
Search and retrieve metadata from the Napster music catalogue or read a user's saved library and listening history.
Use for: Search the Napster catalogue for tracks matching a query, Retrieve the top albums for the rock genre, Find similar artists to a given artist, I need to fetch the biography and image for a specific artist
Not supported: Does not handle audio playback streaming, music licensing, or audio fingerprinting — use for catalogue metadata and user library reads only.
Jentic publishes the only available OpenAPI specification for Napster API, keeping it validated and agent-ready. The Napster API exposes the Napster music catalogue and user library, covering artists, albums, tracks, genres, playlists, and listening history. Public catalogue endpoints are reachable with an API key (apikey query parameter) while user-scoped endpoints under /me require an OAuth2 access token. Agents can search the catalogue, look up rich metadata for artists and albums, retrieve top tracks per genre, and read a logged-in user's saved library and listening history.
Install Jentic One Beta
Connect the Napster API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Napster API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Napster API.
Search the Napster catalogue for matching artists, albums, and tracks in a single request
Retrieve full artist details including biography, images, top tracks, and similar artists
Look up album metadata, track listings, and album cover artwork
Browse top tracks, top artists, and new releases for any genre
Read a logged-in user's saved library of artists, albums, and tracks
Surface a user's recent listening history for personalised recommendations
Use Cases
Patterns agents use Napster API for, with concrete tasks.
★ Music Discovery and Recommendation
Music apps and chat assistants surface recommendations based on a user's tastes by combining genre top-track lists with similar-artist endpoints. The /artists/{artistId}/similar and /genres/{genreId}/tracks/top endpoints return ranked results that can be merged into a recommendation feed without running a custom recommendation model. Catalogue calls only need the apikey query parameter so integration is straightforward.
Call GET /artists/{artistId}/similar then GET /artists/{similarId}/tracks/top to assemble a 20-track playlist of similar artists' best work.
Catalogue Metadata Enrichment
Streaming and editorial platforms use Napster's catalogue endpoints to enrich their own track or album records with artist biographies, cover artwork, and release dates. The /albums/{albumId}/images and /artists/{artistId}/bio endpoints return structured metadata that can backfill missing fields in a third-party catalogue or power editorial pages.
Fetch GET /artists/{artistId}/bio and GET /artists/{artistId}/images for each artist in a catalogue and store the biography and image URLs alongside the local artist record.
User Library and Listening History
Apps that build music dashboards or year-in-review summaries read a user's library and recent listening history through the /me endpoints. These require an OAuth2 access token tied to the user's Napster account so user-specific data stays scoped to the authenticated session. The endpoints return paginated lists of artists, albums, tracks, and recent plays.
Call GET /me/listening-history and aggregate plays by artist over the past 30 days for a personal music dashboard.
AI Agent Music Assistant
An AI assistant invoked through Jentic answers natural-language music questions like 'what are the top jazz tracks this week?' by searching for the matching Napster operation, loading its schema, and executing it. Catalogue endpoints work without a user OAuth flow because the apikey is stored in the Jentic vault as the API key credential.
Search Jentic for 'search music catalogue', load GET /search, and execute it with the user's natural-language query to surface matching tracks, albums, and artists.
Key Endpoints
27 endpoints — jentic publishes the only available openapi specification for napster api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
GET
/search
Search the catalogue across artists, albums, and tracks
GET
/artists/{artistId}
Get artist details
GET
/artists/{artistId}/similar
Get similar artists
GET
/albums/{albumId}
Get album details
GET
/albums/{albumId}/tracks
Get tracks on an album
GET
/genres/{genreId}/tracks/top
Get top tracks for a genre
GET
/me/library/tracks
Get the user's library tracks (OAuth2)
GET
/me/listening-history
Get the user's listening history (OAuth2)
GET
/search
Search the catalogue across artists, albums, and tracks
GET
/artists/{artistId}
Get artist details
GET
/artists/{artistId}/similar
Get similar artists
GET
/albums/{albumId}
Get album details
GET
/albums/{albumId}/tracks
Get tracks on an album
GET
/genres/{genreId}/tracks/top
Get top tracks for a genre
GET
/me/library/tracks
Get the user's library tracks (OAuth2)
GET
/me/listening-history
Get the user's listening history (OAuth2)
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
The Napster apikey query value and OAuth2 access tokens are stored in the Jentic vault. Agents receive scoped execution tokens, so neither the raw apikey nor user OAuth tokens enter the agent's prompt or logs.
Intent-based discovery
Agents search Jentic with intents like 'search music catalogue' or 'get user listening history' and receive the right Napster operation plus its input schema, removing the need to choose between catalogue and /me endpoints manually.
Time to first call
Direct integration: 1-3 days to handle the dual auth model (apikey for catalogue, OAuth2 for /me) and pagination. Through Jentic: under 1 hour — search, load, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Napster API through Jentic.
Why is there no official OpenAPI spec for Napster API?
Napster does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Napster API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Napster API use?
Catalogue endpoints accept an API key passed as the 'apikey' query parameter. User-scoped endpoints under /me (library, listening history) require OAuth2 access tokens tied to a Napster account. Both credentials are stored encrypted in the Jentic vault when called via Jentic.
Can I read a user's library through the Napster API?
Yes, via GET /me/library/artists, GET /me/library/albums, and GET /me/library/tracks. These endpoints require a valid OAuth2 access token. The /me/listening-history endpoint exposes recent plays for the authenticated user.
How do I get similar artists with the Napster API?
Call GET /artists/{artistId}/similar with the artist ID returned from /search or /artists/top. The response is a ranked list of artist objects you can iterate through to build recommendations or related-artist sections.
What are the rate limits for the Napster API?
The OpenAPI spec does not declare rate limits. Refer to the developer.napster.com portal for the current per-key quota. Cache catalogue responses (artists, albums, genres) aggressively because the metadata changes infrequently.
How do I search the Napster catalogue through Jentic?
Run jentic.search('search music catalogue'), load the GET /search operation, then jentic.execute with a query string and the result types you want (artist, album, track). Jentic injects the apikey from the vault and returns the parsed search response.
GET STARTED