Catalog/media-lookup

Data

iTunes lookup by id API

Look up any media item by its Apple iTunes id via the keyless /lookup endpoint, normalized into a single typed record (title, artist, album, genre, year, track count, duration, RSS feed, artwork, store URL, and ids) regardless of media type. Answers 'look up iTunes id 904237743','resolve an Apple media id','get details for a known track/album/podcast/app id'.

Price$0.01per request
MethodPOST
Route/v1/data/media-lookup
StatusLive
MIME typeapplication/json
Rate limit60/minute
Cache3600s public
medialookupitunesidresolveapplemetadataentertainment
API URLhttps://x402.hexl.dev/v1/data/media-lookup
Integration docs
Example request
{
  "id": "201671138",
  "entity": "podcast"
}
Example response
{
  "id": "201671138",
  "found": true,
  "wrapperType": "track",
  "kind": "podcast",
  "item": {
    "title": "This American Life",
    "artist": "This American Life",
    "album": "This American Life",
    "genre": "Society & Culture",
    "year": 2024,
    "releaseDate": "2024-01-01T00:00:00Z",
    "trackCount": 499,
    "durationMs": null,
    "feedUrl": "https://www.thisamericanlife.org/podcast/rss.xml",
    "artworkUrl": "https://is1-ssl.mzstatic.com/.../600x600bb.jpg",
    "url": "https://podcasts.apple.com/us/podcast/.../id201671138",
    "trackId": 201671138,
    "collectionId": 201671138,
    "artistId": null
  }
}
Input schema
{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "examples": [
        "904237743",
        "201671138"
      ]
    },
    "entity": {
      "type": "string",
      "examples": [
        "podcast",
        "album"
      ]
    },
    "country": {
      "type": "string",
      "examples": [
        "US"
      ]
    }
  }
}
Output schema
{
  "type": "object",
  "additionalProperties": true
}