Music album search (iTunes) API

Search music albums via the keyless Apple iTunes Search API, normalized to title, artist, year, genre, track count, price, explicit flag, artwork, store URL, and ids. Emulates album metadata lookups without an API key. Answers 'find the album Rumours','how many tracks on an album','album release year','albums by an artist'.

Price$0.01per request

MethodPOST

Route/v1/data/media-album-search

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

mediamusicalbumdiscographyitunesaudiometadataentertainment

API URLhttps://x402.hexl.dev/v1/data/media-album-search

Integration docs

Example request

{
  "query": "Rumours Fleetwood Mac",
  "limit": 3
}

Example response

{
  "query": "Rumours Fleetwood Mac",
  "count": 1,
  "albums": [
    {
      "title": "Rumours",
      "artist": "Fleetwood Mac",
      "year": 1977,
      "releaseDate": "1977-02-04T08:00:00Z",
      "genre": "Rock",
      "trackCount": 11,
      "price": 9.99,
      "currency": "USD",
      "explicit": false,
      "artworkUrl": "https://is1-ssl.mzstatic.com/.../600x600bb.jpg",
      "url": "https://music.apple.com/us/album/rumours/id123",
      "collectionId": 123,
      "artistId": 456
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "examples": [
        "Rumours",
        "Fleetwood Mac Rumours"
      ]
    },
    "limit": {
      "type": "number",
      "default": 15,
      "examples": [
        10
      ]
    },
    "country": {
      "type": "string",
      "examples": [
        "US"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}