Genius Songs Search Scraper 🎵

Scrape detailed song information from Genius.com search results with ease! This powerful Actor helps you collect comprehensive song data for any search keywords.

🎯 Use Cases

• Music research and analysis
• Song metadata collection
• Artist discography compilation
• Lyrics database building
• Music trend analysis
• Content recommendation systems

✨ Features

• 🔍 Search multiple keywords
• 📊 Configurable maximum items per search
• 🚀 Fast and efficient scraping
• 🤖 Built-in anti-detection mechanisms
• 📱 Random user agent rotation
• ⚡ Automatic scroll pagination
• 💪 Robust error handling

🔢 Output Data Structure

Each scraped song includes:

• Full title
• Artist information
• Release date
• Lyrics URL
• Song stats (views, favorites)
• Album details
• Associated tags
• And more!

💡 Input Parameters

The Actor accepts the following inputs:

• keywords: Array of search terms to scrape
• maxItems: Maximum number of items to scrape per keyword

🚀 Getting Started

1. Create a new task for the Actor
2. Set your desired search keywords
3. Configure the maximum items (optional)
4. Run and collect your data!

💪 Reliability

The Actor implements several reliability features:

• Smart scrolling with random delays
• Automatic retry mechanism
• Request timeout handling
• Memory-efficient processing

📊 Output Format

Results are stored in JSON format, making it easy to process and analyze the data further.

Input Example

A full explanation of an input example in JSON.

1{
2    "keywords": ["rain"],
3    "maxItems": 30
4}

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.

1[
2	{
3		"_type": "song",
4		"annotation_count": 6,
5		"api_path": "/songs/62493",
6		"artist_names": "Adele",
7		"full_title": "Set Fire to the Rain by Adele",
8		"header_image_thumbnail_url": "https://images.genius.com/d33c956e52baece740fcad448281c3d6.300x300x1.png",
9		"header_image_url": "https://images.genius.com/d33c956e52baece740fcad448281c3d6.1000x1000x1.png",
10		"id": 62493,
11		"instrumental": false,
12		"lyrics_owner_id": 53179,
13		"lyrics_state": "complete",
14		"lyrics_updated_at": 1728916713,
15		"path": "/Adele-set-fire-to-the-rain-lyrics",
16		"primary_artist_names": "Adele",
17		"pyongs_count": 107,
18		"relationships_index_url": "https://genius.com/Adele-set-fire-to-the-rain-sample",
19		"release_date_components": {
20			"year": 2011,
21			"month": 1,
22			"day": 24
23		},
24		"release_date_for_display": "January 24, 2011",
25		"release_date_with_abbreviated_month_for_display": "Jan. 24, 2011",
26		"song_art_image_thumbnail_url": "https://images.genius.com/d33c956e52baece740fcad448281c3d6.300x300x1.png",
27		"song_art_image_url": "https://images.genius.com/d33c956e52baece740fcad448281c3d6.1000x1000x1.png",
28		"stats": {
29			"unreviewed_annotations": 1,
30			"concurrents": 2,
31			"hot": false,
32			"pageviews": 2312909
33		},
34		"title": "Set Fire to the Rain",
35		"title_with_featured": "Set Fire to the Rain",
36		"updated_by_human_at": 1728916713,
37		"url": "https://genius.com/Adele-set-fire-to-the-rain-lyrics",
38		"featured_artists": [],
39		"primary_artist": {
40			"_type": "artist",
41			"api_path": "/artists/2300",
42			"header_image_url": "https://images.genius.com/87aa5d8c32965a10e0e7ad1acb54ba40.1000x287x6.gif",
43			"id": 2300,
44			"image_url": "https://images.genius.com/8a23ab928ccfce13accfde72f1290702.1000x1000x1.jpg",
45			"index_character": "a",
46			"is_meme_verified": false,
47			"is_verified": false,
48			"name": "Adele",
49			"slug": "Adele",
50			"url": "https://genius.com/artists/Adele"
51		},
52		"primary_artists": [
53			{
54				"_type": "artist",
55				"api_path": "/artists/2300",
56				"header_image_url": "https://images.genius.com/87aa5d8c32965a10e0e7ad1acb54ba40.1000x287x6.gif",
57				"id": 2300,
58				"image_url": "https://images.genius.com/8a23ab928ccfce13accfde72f1290702.1000x1000x1.jpg",
59				"index_character": "a",
60				"is_meme_verified": false,
61				"is_verified": false,
62				"name": "Adele",
63				"slug": "Adele",
64				"url": "https://genius.com/artists/Adele"
65			}
66		]
67	},
68    ...
69]