Home / API docs / Album Cover Art API
Music

Album Cover Art API

GET /api/music/cover $0.02 per call USDC on Base · x402

Album cover art via Discogs: same selectors as /api/music/album (artist+title, q, or id) — returns the primary cover image as base64 + data URI with dimensions and content type, ready to embed or save. Pairs with /api/music/album.

Parameters

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

Example request

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

Example response

{
    "title": "OK Computer",
    "year": 1997,
    "content_type": "image/jpeg",
    "bytes": 240311,
    "width": 600,
    "height": 600,
    "image_base64": "…",
    "data_uri": "data:image/jpeg;base64,…"
}
MCP tool: get_music_cover — 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.