# StableMusic – Top Albums by Artist

> StableMusic – Top Albums by Artist is a paid API for AI agents from stablemusic.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns the top albums for a given artist using Last.fm data, with pagination and autocorrect support.

## Facts

- Endpoint: POST https://stablemusic.dev/api/tags/top-albums
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stablemusic-top-albums-by-artist-05ecb00a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AqvkaKs7qPQMMjCp_BQuz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stablemusic-top-albums-by-artist-05ecb00a -d '<json body>'
```

Example prompt: What are the top 20 most popular albums by Radiohead according to Last.fm? Use autocorrect in case I spelled the name wrong.

## When to prefer this

Use this endpoint when you need to retrieve a ranked list of top albums for a specific artist from Last.fm. Prefer this over general music search endpoints when you know the artist name and want discography popularity data specifically. Ideal for music recommendation agents, playlist builders, or research tools needing per-artist album charts.

## Known failure modes

- Artist not found on Last.fm — returns empty results or error
- Misspelled artist name with autocorrect disabled — no match found
- Page number out of range — empty results returned
- Rate limit or upstream Last.fm API failure — service error response
- Invalid limit value (below 1 or above 100) — validation error

## How this service works

Pay-per-request Last.fm music discovery for tags, tracks, artists, albums, charts, and country charts.

## Output

A paginated list of top albums for the specified artist, including album names, play counts, and Last.fm URLs. Optionally includes the raw upstream Last.fm response payload.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tag": {
   "type": "string",
   "minLength": 1,
   "description": "Last.fm tag, genre, or category."
  },
  "page": {
   "type": "integer",
   "default": 1,
   "maximum": 9007199254740991,
   "minimum": 1,
   "description": "Last.fm page number. Defaults to 1."
  },
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 100,
   "minimum": 1,
   "description": "Number of results to return. Defaults to 10, max 100."
  },
  "include_raw": {
   "type": "boolean",
   "default": false,
   "description": "Include the upstream Last.fm response payload."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablemusic-top-albums-by-artist-05ecb00a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablemusic.dev](https://www.zero.xyz/host/stablemusic.dev/llms.txt)
