# Genius Scraper β Lyrics, Credits, Samples & Annotations (`haketa/genius-scraper`) Actor
Scrape songs from Genius: full lyrics, credits (producers & writers), samples and interpolations, album, release date, streaming links, tags, stats β plus crowd-sourced annotations. Search songs, sweep an artist's catalog, or target URLs. No token required.
- **URL**: https://apify.com/haketa/genius-scraper.md
- **Developed by:** [Haketa](https://apify.com/haketa) (community)
- **Categories:** Social media, AI
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.75 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
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/docs.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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
πΌ Genius Scraper
Everything about a song from Genius β lyrics, credits, samples, and the annotations behind the words.
    
Enter a song or artist and this Actor exports the **complete picture** of each track from Genius: **full lyrics**, **producer & writer credits**, **album, release date, genres and stats**, **streaming links** β and two things most scrapers miss: the **samples & interpolations graph** (who sampled what) and the crowd-sourced **annotations** that explain the lyrics.
> π **No token, no login, no code.** Type a song or artist and press **Start**.
---
### β¨ Why you'll love it
- π€ **Full lyrics** β clean, complete and in order.
- ποΈ **Rich metadata** β producers, writers, featured artists, album, release date, genres, pageviews and streaming links.
- π **Samples & interpolations graph** β every song this track *samples*, and every track that *sampled, interpolated, covered or remixed* it. Most Genius scrapers don't have this.
- π‘ **Annotations included** β the crowd-sourced explanation behind each line, with votes and author.
- π **Works without a token** β no API keys.
- π§Ή **Clean, structured output** β one row per song, spreadsheet-ready.
---
### π₯ Who it's for
| You are⦠| Use it to⦠|
| :-- | :-- |
| π§ **Music data / analyst** | Build a dataset of songs with full metadata, credits and stats. |
| π¬ **Music supervisor / clearance** | Trace the samples and interpolations behind a track. |
| π€ **NLP / ML engineer** | Get lyrics + explanations for training and research. |
| βοΈ **Writer / journalist** | Pull credits, meaning and context behind songs. |
| π **Researcher / educator** | Study lyrics, references and music-influence networks. |
---
### β‘ Quick start
1. Open the Actor.
2. Enter one or more **Songs** (e.g. `HUMBLE Kendrick Lamar`, or a Genius URL) β *or* enter **Artists** to sweep their popular catalog.
3. Press **Start**, then open the **Output** tab to preview.
4. Hit **Export** β **Excel / CSV / JSON**, or send to **Google Sheets**, **Zapier**, **Make**, or your app via API.
---
### 𧩠Input options
#### π΅ Songs Β· `songs`
Song names (`HUMBLE Kendrick Lamar`), Genius song URLs, or song IDs.
#### π§βπ€ Artists Β· `artists` *(optional)*
Artist names to scrape each one's most popular songs.
#### π’ Songs per artist Β· `maxSongsPerArtist`
How many of each artist's most popular songs to include.
#### π€ Include lyrics Β· `includeLyrics` Β· π‘ Include annotations Β· `includeAnnotations`
Toggle the full lyrics and the crowd-sourced annotations on or off (both on by default).
#### π’ Max songs Β· `maxItems`
Stop after this many songs. Set **0** for no limit.
#### π Proxy Β· `proxyConfiguration`
Required β residential proxies are recommended for this Actor.
---
### π§ͺ Example inputs
πΌ A few songs, fully scraped
```json
{ "songs": ["HUMBLE Kendrick Lamar", "https://genius.com/Kendrick-lamar-not-like-us-lyrics"] }
````
π§βπ€ An artist's popular catalog
```json
{ "artists": ["Kendrick Lamar"], "maxSongsPerArtist": 20, "maxItems": 20 }
```
β‘ Lyrics + metadata only (no annotations, faster)
```json
{ "artists": ["Drake"], "includeAnnotations": false, "maxItems": 30 }
```
***
### π€ Output
One row per song. Only the fields that exist are included.
#### π Field reference
| Field | π Description |
| :-- | :-- |
| `title` Β· `artist` Β· `url` | πΌ Song, artist and Genius URL. |
| `lyrics` | π€ Full lyrics text. |
| `releaseDate` | π
Release date. |
| `producers` Β· `writers` Β· `featuredArtists` | ποΈ Credits. |
| `album` | πΏ Album. |
| `primaryGenre` Β· `tags` | π·οΈ Genre and all tags. |
| `pageviews` | ποΈ Genius pageviews. |
| `spotifyUrl` Β· `youtubeUrl` Β· `appleMusicUrl` Β· `soundcloudUrl` | βΆοΈ Streaming links. |
| `description` | βΉοΈ The song's "About" description. |
| `songRelationships` | π Samples, interpolations, covers, remixes, live versions and translations β each `{type, title, artist, url}`. |
| `sampledInCount` | How many tracks sampled this song. |
| `annotationCount` | Total annotations on the song. |
| `annotations` | π‘ Array of `{fragment, explanation, votes, author, authorIq}`. |
#### πΌ Sample row (trimmed)
```json
{
"title": "HUMBLE.",
"artist": "Kendrick Lamar",
"releaseDate": "2017-03-30",
"producers": "Mike WiLL Made-It, Pluss",
"album": "DAMN.",
"primaryGenre": "Rap",
"pageviews": 12318255,
"spotifyUrl": "https://open.spotify.com/β¦",
"lyrics": "[Intro]\nNobody pray for meβ¦",
"sampledInCount": 34,
"songRelationships": [
{ "type": "samples", "title": "Pulsar City Alarm", "artist": "Adams & Fleisner" },
{ "type": "sampled_in", "title": "β¦", "artist": "β¦" }
],
"annotations": [
{ "fragment": "Watch my soul speakβ¦", "explanation": "β¦", "votes": 809, "author": "ChanLeigh" }
]
}
```
***
### π‘ Use cases in detail
**π Trace a song's musical DNA**
The `songRelationships` field maps what a track samples and everything that sampled, interpolated, covered or remixed it β a directed influence graph for music supervision, clearance and musicology.
**π§ Build a rich music dataset**
Sweep an artist's catalog and export full lyrics, credits, genres, stats and streaming links in one structured table.
**π€ Lyrics + meaning for NLP**
Combine lyrics with their annotations to train or evaluate models on figurative language and reference resolution.
**βοΈ Documented context for content**
Pull credits, samples and the community's explanation of a song for articles and videos.
***
### π§ Tips for best results
- π― **Include the artist** in a song query for the right match.
- β‘ **Turn off annotations** for a faster lyrics + metadata run.
- π **The `songRelationships` field** is where the samples/interpolations graph lives β most scrapers don't provide it.
- π§Ή **Deduplication is automatic** within each run.
***
### π Export & integrations
β¬οΈ **Excel Β· CSV Β· JSON Β· XML** Β· π **Google Sheets & Airtable** Β· π **Webhooks & API** Β· π€ **Make, Zapier, n8n**
***
### β FAQ
**Do I need a token or account?** β No. The Actor works without any login.
**Do I get the samples/interpolations data?** β Yes β the `songRelationships` field lists what a song samples and everything that sampled, interpolated, covered or remixed it.
**Can I scrape a whole artist?** β Yes. Use the **Artists** field and set **Songs per artist**.
**Are annotations included?** β Yes, when **Include annotations** is on: each is a lyric fragment paired with its explanation, votes and author.
**Will I get duplicates?** β No. Songs are deduplicated within each run.
**Can I schedule it?** β Yes, with Apify Schedules.
***
### βοΈ Legal & responsible use
This Actor collects publicly visible song information and community-contributed content for research, education and analysis. Lyrics and annotations are copyrighted and user-generated content; you are responsible for how you use the data, including compliance with applicable laws and platform terms, and you should not redistribute copyrighted content commercially without permission. Always respect the rights of creators and contributors.
# Actor input Schema
## `songs` (type: `array`):
The songs to scrape. Enter a song name (e.g. "HUMBLE Kendrick Lamar"), a Genius song URL, or a song ID. Add as many as you like.
## `artists` (type: `array`):
Optionally, enter artist names (e.g. "Kendrick Lamar", "Taylor Swift") to scrape each artist's most popular songs.
## `maxSongsPerArtist` (type: `integer`):
When using the Artists field, how many of each artist's most popular songs to scrape.
## `includeLyrics` (type: `boolean`):
Include the full lyrics text for each song.
## `includeAnnotations` (type: `boolean`):
Include the crowd-sourced annotations (lyric fragment β explanation, votes and author) for each song.
## `maxItems` (type: `integer`):
Stop after scraping this many songs. Set 0 for no limit.
## `proxyConfiguration` (type: `object`):
Required for reliable collection β residential proxies are recommended for this Actor.
## Actor input object example
```json
{
"songs": [
"HUMBLE Kendrick Lamar",
"https://genius.com/Kendrick-lamar-not-like-us-lyrics"
],
"artists": [
"Kendrick Lamar",
"Drake"
],
"maxSongsPerArtist": 10,
"includeLyrics": true,
"includeAnnotations": true,
"maxItems": 25,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
```
# Actor output Schema
## `dataset` (type: `string`):
Open to view, filter and export all scraped songs (JSON, CSV, Excel).
# 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 = {
"songs": [],
"artists": [],
"maxItems": 25,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("haketa/genius-scraper").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 = {
"songs": [],
"artists": [],
"maxItems": 25,
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
},
}
# Run the Actor and wait for it to finish
run = client.actor("haketa/genius-scraper").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 '{
"songs": [],
"artists": [],
"maxItems": 25,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}' |
apify call haketa/genius-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=haketa/genius-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Genius Scraper β Lyrics, Credits, Samples & Annotations",
"description": "Scrape songs from Genius: full lyrics, credits (producers & writers), samples and interpolations, album, release date, streaming links, tags, stats β plus crowd-sourced annotations. Search songs, sweep an artist's catalog, or target URLs. No token required.",
"version": "0.1",
"x-build-id": "KxFtfLieRLqlrYJWv"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/haketa~genius-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-haketa-genius-scraper",
"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/haketa~genius-scraper/runs": {
"post": {
"operationId": "runs-sync-haketa-genius-scraper",
"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/haketa~genius-scraper/run-sync": {
"post": {
"operationId": "run-sync-haketa-genius-scraper",
"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",
"properties": {
"songs": {
"title": "Songs",
"type": "array",
"description": "The songs to scrape. Enter a song name (e.g. \"HUMBLE Kendrick Lamar\"), a Genius song URL, or a song ID. Add as many as you like.",
"items": {
"type": "string"
}
},
"artists": {
"title": "Artists (optional)",
"type": "array",
"description": "Optionally, enter artist names (e.g. \"Kendrick Lamar\", \"Taylor Swift\") to scrape each artist's most popular songs.",
"items": {
"type": "string"
}
},
"maxSongsPerArtist": {
"title": "Songs per artist",
"minimum": 1,
"type": "integer",
"description": "When using the Artists field, how many of each artist's most popular songs to scrape.",
"default": 10
},
"includeLyrics": {
"title": "Include lyrics",
"type": "boolean",
"description": "Include the full lyrics text for each song.",
"default": true
},
"includeAnnotations": {
"title": "Include annotations",
"type": "boolean",
"description": "Include the crowd-sourced annotations (lyric fragment β explanation, votes and author) for each song.",
"default": true
},
"maxItems": {
"title": "Max songs",
"minimum": 0,
"type": "integer",
"description": "Stop after scraping this many songs. Set 0 for no limit.",
"default": 25
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Required for reliable collection β residential proxies are recommended for this Actor.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```