Napster API

Name: Napster API
Brand: Napster API
Availability: InStock

★ 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.

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.

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 | sh

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 instance

Jentic 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

GET STARTED

Start building with Napster API

Explore with Jentic

View OpenAPI Document

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 your Jentic One instance 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

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Your Napster apikey and OAuth2 access tokens are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'search the music catalogue' or 'get a user's listening history', and Jentic returns the matching Napster operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

Time to first call

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 with Jentic One, the self-hosted execution layer.

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 your Jentic One instance 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.

Can I limit what my agent is allowed to do with the Napster API?

Yes. Because you run Jentic One yourself, your own rules decide which Napster operations and credentials the agent may use, so you can grant read-only catalogue calls like GET /search and GET /artists/{artistId} while leaving the OAuth2 user-library and listening-history reads under /me out entirely unless you add them. Since Napster puts the resource id in the URL path, such as /artists/{artistId} or /albums/{albumId}/tracks, a rule can pin the agent to a single artist or album. The API key and OAuth2 tokens stay stored in your instance and are injected only for the operations you allow.