Apple Music Extractor

Apple Music Artist Search - Apify Actor

This Apify Actor searches for artist information on Apple Music with flexible filtering options. Add multiple artists and customize the type of results you want.

Features

• Multiple Artists: Add one or multiple artist names (click + to add more)
• Filter by Type: Choose what to get - all info, artist details, songs only, or albums only
• Result Limit: Control how many results to return (default: 10)
• Response Format: Choose between organized or simple format
• Concurrent Processing: All searches run simultaneously for maximum speed

Prerequisites

Before running this actor, you must set the API URL as an environment variable in Apify Console:

Input Schema

{
  "artistNames": ["Taylor Swift", "The Beatles"],
  "type": "all",
  "limit": 10,
  "format": "organized"
}

Input Parameters

Parameter	Type	Required	Default	Description
artistNames	array of strings	Yes	-	List of artist names to search. Click '+' to add multiple artists.
type	string	No	"all"	Filter results by type: "all", "artist", "songs", or "albums"
limit	integer	No	10	Limit number of results (1-100)
format	string	No	"organized"	Response format: "organized" or "simple"

Filter Type Options

• all - Get everything: artist info, songs, and albums
• artist - Get only artist information (no songs or albums)
• songs - Get only songs from the artist
• albums - Get only albums from the artist

Response Format Options

• organized - Results grouped by type (artist, songs, albums)
• simple - Raw results without grouping

Output

The actor outputs results in two ways:

1. Dataset: Each artist search result is pushed to the dataset
2. OUTPUT Key-Value Store: Summary with all results

Output Structure

Each result in the dataset contains:

{
  "artist": "Taylor Swift",
  "status": "success",
  "status_code": 200,
  "data": {
    "artist_searched": "Taylor Swift",
    "data": {
      "artist": {
        "name": "Taylor Swift",
        "id": "...",
        ...
      },
      "songs": [
        {
          "title": "Anti-Hero",
          "album": "Midnights",
          ...
        }
      ],
      "albums": [
        {
          "title": "Midnights",
          "release_date": "2022",
          ...
        }
      ]
    }
  }
}

Summary Output (Key-Value Store)

{
  "total_searches": 4,
  "successful": 4,
  "errors": 0,
  "filter_settings": {
    "type": "all",
    "limit": 10,
    "format": "organized"
  },
  "results": [...]
}

Usage Examples

Example 1: Single Artist - Get All Information

{
  "artistNames": [
    "Taylor Swift"
  ],
  "type": "all",
  "limit": 10,
  "format": "organized"
}

Example 2: Multiple Artists - Get All Information

{
  "artistNames": [
    "Taylor Swift",
    "The Beatles",
    "Drake",
    "Adele"
  ],
  "type": "all",
  "limit": 10,
  "format": "organized"
}

Example 3: Get Only Songs

{
  "artistNames": [
    "Beyoncé",
    "Ed Sheeran",
    "Ariana Grande"
  ],
  "type": "songs",
  "limit": 15,
  "format": "organized"
}

Example 4: Get Only Albums

{
  "artistNames": [
    "The Weeknd",
    "Coldplay"
  ],
  "type": "albums",
  "limit": 5,
  "format": "organized"
}

Example 5: Get Only Artist Info

{
  "artistNames": [
    "Bruno Mars",
    "Post Malone",
    "Dua Lipa"
  ],
  "type": "artist",
  "limit": 10,
  "format": "organized"
}

Example 6: Simple Format Response

{
  "artistNames": [
    "Billie Eilish"
  ],
  "type": "all",
  "limit": 20,
  "format": "simple"
}

How It Works

1. Add Artist Names: Enter one or more artist names
2. Select Filter Type: Choose what information you want (all, artist, songs, albums)
3. Set Result Limit: Decide how many results to get per artist (default: 10)
4. Choose Format: Pick organized (grouped) or simple format
5. Run: The actor searches all artists concurrently and returns results

Error Handling

If a search fails, the result will have:

{
  "artist": "Artist Name",
  "status": "error",
  "error": "Error message here"
}

Common errors:

• Missing required environment variable: API_URL - API URL not set in environment
• HTTP error: ... - API request failed
• Request timeout - API took too long to respond (>30 seconds)

Performance

• All searches run concurrently for maximum speed
• Default timeout: 30 seconds per request
• No limit on the number of artists you can search
• Filter settings apply to all artists in the batch

Setup Instructions

1. Create the Actor in Apify Console
2. Set Environment Variables:
   • Go to Actor Settings → Environment variables
   • Add API_URL with your API endpoint
   • (Optional) Add API_KEY if authentication is required
3. Configure Input:
   • Add artist names (click + to add more)
   • Select filter type
   • Set result limit (default: 10)
   • Choose response format
4. Run the Actor

API Authentication

If your API requires authentication, the actor will automatically include the API key from the API_KEY environment variable in the request headers:

Authorization: Bearer YOUR_API_KEY

Local Development

1. Create input file input.json:

{
  "artistNames": ["Taylor Swift", "The Beatles"],
  "type": "all",
  "limit": 10,
  "format": "organized"
}

2. Run locally:

$apify run

Tips

• Use type: "songs" when you only need song information (faster)
• Use type: "albums" when you only need album information (faster)
• Use type: "artist" when you only need basic artist details (fastest)
• Increase limit to get more results per artist
• Use format: "simple" if you want raw, ungrouped data

Support

For issues or questions, please contact support or create an issue in the repository.