Genius Albums Search Scraper 🎵

Scrape album search results from Genius.com with ease! This actor helps you collect comprehensive album information based on your search keywords.

Features ✨

• 🔍 Search albums by keywords
• 📊 Get detailed album metadata
• 🎯 Control maximum number of results
• 🚀 Fast and efficient scraping
• 🤖 Built-in anti-detection mechanisms
• ⚡ Supports parallel processing

Usage 💡

Simply provide your search keywords and maximum items limit, and the actor will do the rest!

Input Parameters 📝

The actor accepts the following input parameters:

Parameter	Type	Description
keywords	Array	List of search terms to find albums
maxItems	Integer	Maximum number of albums to scrape

Output 📋

The actor outputs detailed album information including:

• Album title
• Artist name
• Release date
• Cover art URL
• Album URL
• Track count
• And more!

Use Cases 🎯

• Music research and analysis
• Building music databases
• Tracking new album releases
• Content aggregation
• Market research

Limitations ⚠️

• Respects Genius.com's rate limits
• Maximum 10000 results per search term
• Public data only

Need help or have questions? Feel free to reach out! 🤝

Input Example

A full explanation of an input example in JSON.

{
    "keywords": ["rain"],
    "maxItems": 30
}

Output sample

The results will be wrapped into a dataset which you can always find in the Storage tab. Here's an excerpt from the data you'd get if you apply the input parameters above:

And here is the same data but in JSON. You can choose in which format to download your data: JSON, JSONL, Excel spreadsheet, HTML table, CSV, or XML.

[
	{
		"_type": "album",
		"api_path": "/albums/351502",
		"cover_art_thumbnail_url": "https://images.genius.com/02644e12a8d4c76381c325d896f13c0f.300x300x1.png",
		"cover_art_url": "https://images.genius.com/02644e12a8d4c76381c325d896f13c0f.1000x1000x1.png",
		"full_title": "Rainbow by Kesha",
		"id": 351502,
		"name": "Rainbow",
		"name_with_artist": "Rainbow (artist: Kesha)",
		"primary_artist_names": "Kesha",
		"release_date_components": {
			"year": 2017,
			"month": 8,
			"day": 11
		},
		"release_date_for_display": "August 11, 2017",
		"url": "https://genius.com/albums/Kesha/Rainbow",
		"artist": {
			"_type": "artist",
			"api_path": "/artists/1519",
			"header_image_url": "https://images.genius.com/5599bb8a911e1fe2474412f2ea67be38.1000x563x1.jpg",
			"id": 1519,
			"image_url": "https://images.genius.com/1a212c61b55ca74620a0050157bb99bb.1000x1000x1.png",
			"index_character": "k",
			"is_meme_verified": false,
			"is_verified": true,
			"name": "Kesha",
			"slug": "Kesha",
			"url": "https://genius.com/artists/Kesha",
			"iq": 1380
		},
		"primary_artists": [
			{
				"_type": "artist",
				"api_path": "/artists/1519",
				"header_image_url": "https://images.genius.com/5599bb8a911e1fe2474412f2ea67be38.1000x563x1.jpg",
				"id": 1519,
				"image_url": "https://images.genius.com/1a212c61b55ca74620a0050157bb99bb.1000x1000x1.png",
				"index_character": "k",
				"is_meme_verified": false,
				"is_verified": true,
				"name": "Kesha",
				"slug": "Kesha",
				"url": "https://genius.com/artists/Kesha",
				"iq": 1380
			}
		]
	},
    ...
]