# iTunes & Apple Music Scraper (`moving_beacon-owner1/my-actor-81`) Actor Scrape music, podcasts, movies, TV shows, audiobooks, and apps from Apple's iTunes Store. Search the entire Apple media catalogue β€” extract artists, albums, songs, podcast episodes, prices, ratings, artwork, and preview URLs. - **URL**: https://apify.com/moving\_beacon-owner1/my-actor-81.md - **Developed by:** [Jamshaid Arif](https://apify.com/moving_beacon-owner1) (community) - **Categories:** Developer tools, Other, Automation - **Stats:** 2 total users, 1 monthly users, 75.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $10.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🎡 iTunes & Apple Music Scraper **Scrape music, podcasts, movies, TV shows, audiobooks, and apps from [Apple's iTunes Store](https://www.apple.com/itunes/)**. Search the entire Apple media catalog β€” extract artists, albums, songs, podcast episodes, prices, ratings, artwork, and preview URLs. Free API. No key required. No login needed. --- ### What does this actor do? This actor queries Apple's public iTunes Search API to retrieve structured metadata for any media in the Apple ecosystem. It covers Apple Music, Apple Podcasts, iTunes Movies, Apple TV, Apple Books, and the App Store. **Use it to:** - Search Apple Music for songs, albums, and artists - Find and compare podcasts with episode details - Research movie and TV show pricing across countries - Build music or podcast databases with artwork - Monitor app pricing and ratings on the App Store - Get an artist's complete discography (albums + songs) - Fetch full episode lists for any podcast --- ### Scrape modes | Mode | What it does | Required input | |------|-------------|----------------| | **Search** | Keyword search across the iTunes catalog | `search_term` | | **Lookup** | Fetch items by their iTunes/Apple IDs | `itunes_ids` | | **Artist Albums & Songs** | Get an artist's discography | `itunes_ids` (artist IDs) | | **Podcast Episodes** | Get all episodes of a podcast | `itunes_ids` (podcast IDs) | --- ### Media types & entities | Media Type | Available Entities | |------------|-------------------| | **Music** | `song`, `album`, `musicArtist`, `musicVideo`, `mix` | | **Podcast** | `podcast`, `podcastEpisode`, `podcastAuthor` | | **Movie** | `movie`, `movieArtist` | | **TV Show** | `tvSeason`, `tvEpisode` | | **Audiobook** | `audiobook`, `audiobookAuthor` | | **App** | `software`, `iPadSoftware`, `macSoftware` | | **eBook** | `ebook` | --- ### Input examples #### Example 1: Search for Taylor Swift songs ```json { "scrape_mode": "search", "search_term": "Taylor Swift", "media_type": "music", "entity": "song", "country": "US", "max_results": 50 } ```` #### Example 2: Search for true crime podcasts ```json { "scrape_mode": "search", "search_term": "true crime", "media_type": "podcast", "max_results": 30 } ``` #### Example 3: Get an artist's full discography ```json { "scrape_mode": "artist_albums", "itunes_ids": "136975", "country": "US", "max_results": 100 } ``` > **Finding Artist IDs:** Search for the artist first, then use the `artist_id` from results. Example: Taylor Swift = `159260351`, Drake = `271256`, BeyoncΓ© = `1419227`. #### Example 4: Fetch all episodes of a podcast ```json { "scrape_mode": "podcast_episodes", "itunes_ids": "1200361736", "max_results": 200 } ``` > **Finding Podcast IDs:** Search for the podcast first, then use the `collection_id` from results. The ID is also in the Apple Podcasts URL. #### Example 5: Search movies in the UK store ```json { "scrape_mode": "search", "search_term": "Christopher Nolan", "media_type": "movie", "attribute": "directorTerm", "country": "GB", "max_results": 20 } ``` #### Example 6: Look up specific items by ID ```json { "scrape_mode": "lookup", "itunes_ids": "1440935467, 1440783204, 1443749923", "country": "US" } ``` *** ### Output format #### Music track record ```json { "rank": 1, "wrapper_type": "track", "kind": "song", "artist_id": 159260351, "artist_name": "Taylor Swift", "collection_id": 1440935467, "collection_name": "1989 (Deluxe)", "track_id": 1440935580, "track_name": "Blank Space", "name": "Blank Space", "artist_url": "https://music.apple.com/us/artist/taylor-swift/159260351", "track_url": "https://music.apple.com/us/album/blank-space/1440935467?i=1440935580", "preview_url": "https://audio-ssl.itunes.apple.com/...", "artwork": { "small": "https://is1-ssl.mzstatic.com/.../100x100bb.jpg", "medium": "https://is1-ssl.mzstatic.com/.../300x300bb.jpg", "large": "https://is1-ssl.mzstatic.com/.../600x600bb.jpg" }, "price": 1.29, "price_formatted": "$1.29", "currency": "USD", "genre": "Pop", "release_date": "2014-10-27T07:00:00Z", "duration_ms": 231833, "duration_formatted": "3:51", "explicit": "notExplicit", "is_streamable": true } ``` #### Podcast record ```json { "rank": 1, "kind": "podcast", "collection_id": 1200361736, "collection_name": "The Daily", "artist_name": "The New York Times", "genre": "News", "feed_url": "https://feeds.simplecast.com/...", "episode_count": 2500, "artwork": { "small": "https://...100x100bb.jpg", "medium": "https://...300x300bb.jpg", "large": "https://...600x600bb.jpg" }, "price_formatted": "Free" } ``` #### Podcast episode record ```json { "rank": 5, "kind": "podcast-episode", "track_name": "The Sunday Read: 'The Rise of...'", "collection_name": "The Daily", "episode_url": "https://dts.podtrac.com/...", "episode_description": "A deep dive into...", "episode_duration_ms": 2580000, "release_date": "2026-04-01T09:00:00Z" } ``` *** ### Finding IDs Every item in the Apple ecosystem has a numeric ID. You can find them in several ways: **From URLs:** The number in any Apple Music, Podcasts, or iTunes URL is the ID: ``` https://music.apple.com/us/artist/taylor-swift/159260351 ^^^^^^^^^ Artist ID = 159260351 https://podcasts.apple.com/us/podcast/the-daily/id1200361736 ^^^^^^^^^^ Podcast ID = 1200361736 ``` **From Search results:** Run a Search first, then use `artist_id`, `collection_id`, or `track_id` from the output. #### Popular Artist IDs | Artist | ID | |--------|-----| | Taylor Swift | `159260351` | | Drake | `271256` | | BeyoncΓ© | `1419227` | | The Beatles | `136975` | | Kendrick Lamar | `368183298` | | Billie Eilish | `1065981054` | *** ### Search attributes Narrow your search by setting the `attribute` field: | Media | Attributes | |-------|-----------| | **Music** | `songTerm`, `albumTerm`, `artistTerm`, `genreIndex`, `composerTerm`, `mixTerm` | | **Podcast** | `titleTerm`, `authorTerm`, `genreIndex`, `descriptionTerm` | | **Movie** | `actorTerm`, `directorTerm`, `producerTerm`, `genreIndex`, `ratingTerm` | | **TV** | `showTerm`, `genreIndex`, `ratingTerm` | | **App** | `softwareDeveloper` | *** ### Country stores Set `country` to get results from different Apple regional stores. Pricing and availability varies by country. | Code | Country | | Code | Country | |------|---------|-|------|---------| | `US` | United States | | `JP` | Japan | | `GB` | United Kingdom | | `IN` | India | | `CA` | Canada | | `BR` | Brazil | | `AU` | Australia | | `KR` | South Korea | | `DE` | Germany | | `MX` | Mexico | | `FR` | France | | `PK` | Pakistan | *** ### Cost and performance | Mode | Items | Time | Credits | |------|-------|------|---------| | Search (50 results) | 50 | ~5 sec | < $0.01 | | Lookup (10 IDs) | 10 | ~3 sec | < $0.01 | | Artist discography | ~50 | ~10 sec | < $0.01 | | Podcast episodes (200) | 200 | ~8 sec | < $0.01 | *** ### Tips - **Start with Search mode** to find IDs, then use Lookup or Artist Albums for detailed data. - **Set `entity`** for precise results β€” `song` vs `album` vs `musicArtist` returns very different data. - **Use `attribute`** to narrow searches β€” `directorTerm` for movies, `artistTerm` for music. - **Preview URLs** provide 30-second audio/video clips you can use in apps. - **Artwork URLs** can be resized β€” replace the dimensions in the URL (e.g., `600x600` β†’ `1200x1200`). - **Rate limit** is ~20 requests/minute. The actor adds 3.5s delays automatically. - **Podcast IDs** sometimes differ from what you see on the website β€” verify with a Search first. *** ### Limitations - iTunes API returns max 200 results per search query. - Rate limit of ~20 requests per minute per IP. - Some content may be region-locked and unavailable in certain countries. - Apple Music streaming URLs are not available (only 30-second previews). - Full song lyrics are not provided by the API. - Historical pricing data is not available β€” only current prices. *** ### Changelog #### v1.0.0 (2026-04-05) - Initial release - 4 scrape modes: search, lookup, artist albums/songs, podcast episodes - 8 media types: music, podcasts, movies, TV, audiobooks, apps, ebooks, all - 16 country stores supported - Artwork in 3 sizes (100px, 300px, 600px) - Smart field extraction per content type (music, podcast, movie, app-specific fields) - Rate limiting with automatic retry on 429 # Actor input Schema ## `scrape_mode` (type: `string`): How to search the iTunes catalog. ## `search_term` (type: `string`): Keywords to search for (Search mode). Examples: 'Taylor Swift', 'true crime podcast', 'inception movie'. ## `media_type` (type: `string`): Type of media to search for. ## `entity` (type: `string`): Specific entity to search for within the media type. Leave empty for default. Music: song, album, musicArtist, musicVideo. Podcast: podcast, podcastEpisode. Movie: movie, movieArtist. TV: tvSeason, tvEpisode. ## `itunes_ids` (type: `string`): Comma-separated iTunes/Apple IDs for Lookup, Artist Albums, or Podcast Episodes modes. Find IDs in iTunes URLs or from Search results. ## `country` (type: `string`): Two-letter ISO country code for the iTunes store to search. Affects availability and pricing. ## `max_results` (type: `integer`): Maximum results per search (1–200). iTunes API cap is 200. ## `explicit` (type: `boolean`): Include explicit/mature content in results. ## `attribute` (type: `string`): Narrow search to a specific attribute. Leave empty for all. Music: songTerm, albumTerm, artistTerm, genreIndex. Podcast: titleTerm, authorTerm. Movie: actorTerm, directorTerm. ## `proxy_configuration` (type: `object`): Proxy settings. iTunes API allows ~20 requests/minute. ## Actor input object example ```json { "scrape_mode": "search", "search_term": "Taylor Swift", "media_type": "all", "entity": "", "itunes_ids": "", "country": "US", "max_results": 50, "explicit": true, "attribute": "" } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "search_term": "Taylor Swift" }; // Run the Actor and wait for it to finish const run = await client.actor("moving_beacon-owner1/my-actor-81").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "search_term": "Taylor Swift" } # Run the Actor and wait for it to finish run = client.actor("moving_beacon-owner1/my-actor-81").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "search_term": "Taylor Swift" }' | apify call moving_beacon-owner1/my-actor-81 --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=moving_beacon-owner1/my-actor-81", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "iTunes & Apple Music Scraper", "description": "Scrape music, podcasts, movies, TV shows, audiobooks, and apps from Apple's iTunes Store. Search the entire Apple media catalogue β€” extract artists, albums, songs, podcast episodes, prices, ratings, artwork, and preview URLs.", "version": "0.0", "x-build-id": "Tt0vOQV1NOjplzBE0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/moving_beacon-owner1~my-actor-81/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-moving_beacon-owner1-my-actor-81", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/moving_beacon-owner1~my-actor-81/runs": { "post": { "operationId": "runs-sync-moving_beacon-owner1-my-actor-81", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/moving_beacon-owner1~my-actor-81/run-sync": { "post": { "operationId": "run-sync-moving_beacon-owner1-my-actor-81", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "scrape_mode" ], "properties": { "scrape_mode": { "title": "Scrape Mode", "enum": [ "search", "lookup", "artist_albums", "podcast_episodes" ], "type": "string", "description": "How to search the iTunes catalog.", "default": "search" }, "search_term": { "title": "Search Term", "type": "string", "description": "Keywords to search for (Search mode). Examples: 'Taylor Swift', 'true crime podcast', 'inception movie'.", "default": "" }, "media_type": { "title": "Media Type", "enum": [ "all", "music", "podcast", "movie", "tvShow", "audiobook", "software", "ebook" ], "type": "string", "description": "Type of media to search for.", "default": "all" }, "entity": { "title": "Entity Type", "type": "string", "description": "Specific entity to search for within the media type. Leave empty for default. Music: song, album, musicArtist, musicVideo. Podcast: podcast, podcastEpisode. Movie: movie, movieArtist. TV: tvSeason, tvEpisode.", "default": "" }, "itunes_ids": { "title": "iTunes IDs", "type": "string", "description": "Comma-separated iTunes/Apple IDs for Lookup, Artist Albums, or Podcast Episodes modes. Find IDs in iTunes URLs or from Search results.", "default": "" }, "country": { "title": "Country Store", "enum": [ "US", "GB", "CA", "AU", "DE", "FR", "JP", "IN", "BR", "MX", "ES", "IT", "NL", "SE", "KR", "PK" ], "type": "string", "description": "Two-letter ISO country code for the iTunes store to search. Affects availability and pricing.", "default": "US" }, "max_results": { "title": "Max Results", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum results per search (1–200). iTunes API cap is 200.", "default": 50 }, "explicit": { "title": "Include Explicit Content", "type": "boolean", "description": "Include explicit/mature content in results.", "default": true }, "attribute": { "title": "Search Attribute", "type": "string", "description": "Narrow search to a specific attribute. Leave empty for all. Music: songTerm, albumTerm, artistTerm, genreIndex. Podcast: titleTerm, authorTerm. Movie: actorTerm, directorTerm.", "default": "" }, "proxy_configuration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. iTunes API allows ~20 requests/minute." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```