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
Actor stats
0
Bookmarked
3
Total users
0
Monthly active users
12 hours 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.
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.
Chart mode
Fetch today's Top Charts for any country. Returns ranked items from Apple Music's publicly visible charts page.
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.
