iTunes Apple Music Catalog & Charts Scraper
Pricing
Pay per event
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. Metadata and 30-second preview URLs only — no audio downloads.
Pricing
Pay per event
Rating
0.0
(0)
Developer
BowTiedRaccoon
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
2 days ago
Last modified
Categories
Share
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.