iTunes Apple Music Catalog & Charts Scraper

Search the iTunes/Apple Music catalog by keyword, artist, or album; look up tracks by Apple ID; and fetch Top Charts rankings for any country. Returns metadata and Apple-provided 30-second preview URLs — no audio downloads.

What you get

Each result is a flat record with these fields:

Field	Description
mode	Source mode: search, lookup, or chart
track_id	Apple track ID
collection_id	Apple album/collection ID
artist_id	Apple artist ID
wrapper_type	Result type: track, collection, or artist
kind	Item kind, e.g. song or music-video
artist_name	Artist name
collection_name	Album name
track_name	Track name
genre	Primary genre
release_date	Release date (YYYY-MM-DD)
track_count	Number of tracks in the album
track_number	Track number within the album
track_time_millis	Duration in milliseconds
country	Storefront country code
currency	Pricing currency (e.g. USD)
is_streamable	Whether the track is streamable via Apple Music
preview_url	Apple-provided 30-second preview URL (AAC)
artwork_url	Album artwork URL (500×500)
collection_price	Album price in local currency
track_price	Track price in local currency
apple_music_url	Apple Music URL for this item
chart_rank	Chart rank position (chart mode only)
chart_name	Chart name, e.g. most-played (chart mode only)

Usage

Search mode (default)

Search for songs, albums, or artists by keyword. Powered by the official iTunes Search API.

{
  "mode": "search",
  "searchTerm": "radiohead",
  "entity": "song",
  "country": "us",
  "maxItems": 50
}

Entity options: song, album, musicArtist, musicTrack, allArtist, allTrack

Lookup mode

Look up catalog metadata by Apple ID (track, album, or artist ID). Useful for enriching datasets that already contain Apple IDs.

{
  "mode": "lookup",
  "lookupId": 657515,
  "lookupEntity": "album",
  "country": "us",
  "maxItems": 20
}

Chart mode

Fetch today's Top Charts for any country. Returns ranked items from Apple Music's publicly visible charts page.

{
  "mode": "chart",
  "country": "us",
  "maxItems": 50
}

Supported countries: any ISO 3166-1 alpha-2 code supported by the Apple Music storefront (e.g. us, gb, jp, de, fr, br, au).

Rate limiting

The iTunes Search and Lookup APIs have a soft limit of approximately 20 requests per minute. This actor applies a 3-second delay between requests to stay within that limit. For large searches, use a modest maxItems value and run multiple actors in parallel with different search terms.

Notes

• Metadata only. This actor returns Apple-provided 30-second preview URLs and catalog metadata. It does not fetch, stream, or host full-track audio.
• No authentication required. The iTunes Search and Lookup APIs are publicly accessible without an API key.
• Chart data is country-specific. Each run fetches charts for a single country. For multi-country charts, run separate instances.
• Apple catalog IDs (track, collection, and artist IDs) join cleanly with MusicBrainz, Discogs, Spotify, and other music databases for cross-platform enrichment.