Home / API docs / Album Metadata API
Music

Album Metadata API

GET /api/music/album $0.01 per call USDC on Base · x402

Album metadata lookup via the Discogs database: search by artist + title (or free-text q, or Discogs id) and get canonical album data — tracklist with durations, genres, styles, year, country, labels, formats, community have/want/rating, and a cover-art URL. For music, playlist, and cataloging agents.

Parameters

NameInDescription
artistqueryArtist name (with title)
titlequeryAlbum title (with artist)
qqueryFree-text search alternative
idqueryDirect Discogs id (with optional kind)
kindquerymaster (default) or release, for id lookups

Example request

curl "https://api.webbersites.com/api/music/album?artist=Radiohead&title=OK%20Computer"
# first call returns 402 + payment requirements; an x402 client pays and retries automatically

Example response

{
    "title": "OK Computer",
    "artists": [
        "Radiohead"
    ],
    "year": 1997,
    "genres": [
        "Electronic",
        "Rock"
    ],
    "tracklist": [
        {
            "position": "1",
            "title": "Airbag",
            "duration": "4:44"
        }
    ],
    "community": {
        "have": 120000,
        "want": 45000,
        "rating": 4.6
    },
    "cover_endpoint": "/api/music/cover?id=32063&kind=master"
}
MCP tool: get_music_album — via npx -y webbersites-x402-mcp (local, key stays on your machine) or the remote endpoint https://api.webbersites.com/mcp.

How payment works

There is no signup and no API key. Call the endpoint; it replies 402 Payment Required with machine-readable payment requirements. Your client signs a USDC transfer authorization (EIP-3009, gasless) and retries with the X-PAYMENT header — @x402/fetch does this automatically. See the overview for a working snippet.