# Genius Scraper (`epctex/genius-scraper`) Actor
The Genius.com scraper extracts songs and lyrics from the platform. It fetches details from song, album, artist pages, supports tag-based retrieval, searches, and includes comments. Simplify accessing and analyzing music content from Genius.com.
- **URL**: https://apify.com/epctex/genius-scraper.md
- **Developed by:** [epctex](https://apify.com/epctex) (community)
- **Categories:** Social media
- **Stats:** 304 total users, 7 monthly users, 99.7% runs succeeded, 19 bookmarks
- **User rating**: 5.00 out of 5 stars
## Pricing
$5.00/month + usage
To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors
## 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
## Actor - Genius Scraper
### Genius scraper
The Genius.com scraper is a versatile tool designed to extract songs and lyrics from the popular music platform, Genius. With this powerful scraper, you can easily fetch songs and lyrics using various parameters such as song details, albums, artists, and tag detail pages. Whether you're looking for a specific song, exploring an artist's discography, or searching for songs based on specific tags, our scraper provides a seamless solution for accessing the desired music content from Genius.com. Unlock a wealth of musical knowledge and lyrics with our reliable and efficient Genius.com scraper.
The Genius.com data scraper offers a range of distinct features for versatile data retrieval:
- Song detail - Extract songs and lyrics from individual song detail pages, providing comprehensive information about specific tracks.
- Album detail: Gather songs and lyrics from album detail pages, allowing for a comprehensive view of a particular album's musical content.
- Artist detail: Retrieve songs and lyrics from artist detail pages, providing access to a specific artist's discography and their corresponding lyrics.
- Tags: Fetch song details and lyrics from tag pages, enabling exploration and extraction based on specific genres, themes, or labels.
- Search: Utilize keyword and search mode parameters to conduct targeted searches, swiftly locating songs and lyrics that align with your specific criteria.
- Comments: Customize your scraping preferences by specifying whether to include comments, tailoring the extracted data to focus solely on songs and lyrics, or incorporating user comments for a more comprehensive analysis.
### Bugs, fixes, updates, and changelog
This scraper is under active development. If you have any feature requests you can create an issue from [here](https://github.com/epctex-support/genius-scraper/issues).
### Input Parameters
The input of this scraper should be JSON containing the list of pages on Genius.com that should be visited. Required fields are:
- `search`: (Optional) (String) The keyword that you can search on Genius.
- `searchMode`: (Optional) (String) What type of search do you want to make at Genius.
- `startUrls`: (Optional) (Array) List of Genius.com URLs. You should only provide song, album, artist detail, and tag URLs.
- `includeComments`: (Optional) (Boolean) Should comments be included in songs.
- `endPage`: (Optional) (Number) Final number of page that you want to scrape. The default is `Infinite`. This applies to all `search` requests and `startUrls` individually.
- `maxItems`: (Optional) (Number) You can limit scraped items. This should be useful when you search through the big lists or search results.
- `proxy`: (Required) (Proxy Object) Proxy configuration.
- `extendOutputFunction`: (Optional) (String) Function that takes a JQuery handle ($) as an argument and returns an object with data.
- `customMapFunction`: (Optional) (String) Function that takes each object's handle as an argument and returns the object with executing the function.
This solution requires the use of **Proxy servers**, either your own proxy servers or you can use [Apify Proxy](https://www.apify.com/docs/proxy).
#### Tip
When you want to scrape over a specific list URL, just copy and paste the link as one of the **startUrl**.
If you would like to scrape only the first page of a list then put the link for the page and have the `endPage` as 1.
With the last approach that is explained above you can also fetch any interval of pages. If you provide the 5th page of a list and define the `endPage` parameter as 6 then you'll have the 5th and 6th pages only.
#### Compute Unit Consumption
The actor is optimized to run blazing fast and scrape as many items as possible. Therefore, it forefronts all the detailed requests. If the actor doesn't block very often it'll scrape 100 listings in 2 minutes with ~0.02-0.04 compute units.
#### Genius.com Scraper Input example
```json
{
"startUrls": [
"https://genius.com/Fifty-fifty-cupid-twin-version-lyrics",
"https://genius.com/albums/Fifty-fifty/The-beginning-cupid",
"https://genius.com/artists/Drake",
"https://genius.com/tags/pop",
"https://genius.com/search?q=tiktok"
],
"search": "",
"searchMode": "song",
"includeComments": false,
"proxy": {
"useApifyProxy": true
},
"endPage": 5,
"maxItems": 100
}
````
### During the Run
During the run, the actor will output messages letting you know what is going on. Each message always contains a short label specifying which page from the provided list is currently specified.
When items are loaded from the page, you should see a message about this event with a loaded item count and total item count for each page.
If you provide incorrect input to the actor, it will immediately stop with a failure state and output an explanation of what is wrong.
### Genius.com Export
During the run, the actor stores results into a dataset. Each item is a separate item in the dataset.
You can manage the results in any language (Python, PHP, Node JS/NPM). See the FAQ or our API reference to learn more about getting results from this Genius.com actor.
### Scraped Genius.com Properties
The structure of each item in Genius.com looks like this:
#### Item Detail
```json
{
"type": "song",
"url": "https://genius.com/Post-malone-rockstar-lyrics",
"id": 2942139,
"lyrics": "[Intro: Post Malone]
\nHahahahaha
\nTank God
\nAyy, ayy
\n
\n[Chorus: Post Malone]
\nI've been fuckin' hoes and poppin' pillies
\nMan, I feel just like a rockstar (Star, ayy, ayy)
\nAll my brothers got that gas
\nAnd they always be smokin' like a Rasta ('Sta)
\nFuckin' with me, call up on a Uzi
\nAnd show up, man, them the shottas ('Tas)
\nWhen my homies pull up on your block
\nThey make that thing go grrra-ta-ta-ta (Ta, pow, pow, pow, ayy, ayy)
\n
\n[Verse 1: Post Malone]
\n
\nClose that door, we blowin' smoke
\nShe ask me light a fire like I'm Morrison ('Son, ayy)
\nAct a fool on stage
\nProlly leave my fuckin' show in a cop car (Car, ayy)
\nShit was legendary
\nThrew a TV out the window of the Montage
\nCocaine on the table, liquor pourin', don't give a damn
\nDude, your girlfriend is a groupie, she just tryna get in
\nSayin', \"I'm with the band\" (Ayy, ayy)
\nNow she actin' outta pocket, tryna grab up on my pants
\nHundred bitches in my trailer say they ain't got a man
\nAnd they all brought a friend (Yeah, ayy, ayy, ayy)
\n
\n[Chorus: Post Malone]
\nI've been fuckin' hoes and poppin' pillies
\nMan, I feel just like a rockstar (Star, ayy, ayy)
\nAll my brothers got that gas
\nAnd they always be smokin' like a Rasta ('Sta)
\nFuckin' with me, call up on a Uzi
\nAnd show up, man, them the shottas ('Tas)
\nWhen my homies pull up on your block
\nThey make that thing go grrra-ta-ta-ta (Ta, pow, pow, pow)
\n
\n[Verse 2: 21 Savage]
\n
\nDrankin' Henny, bad bitches jumpin' in the pool
\nAnd they ain't got on no bra (Bra)
\n
\n
\n
\nYour wifey say I'm lookin' like a whole snack (Big snack)
\nGreen hundreds in my safe, I got old racks (Old racks)
\nL.A. bitches always askin', \"Where the coke at?\" (21, 21)
\nLivin' like a rockstar, smash out on a cop car
\nSweeter than a Pop-Tart, you know you are not hard
\nI done made the hot chart, 'member I used to trap hard
\nLivin' like a rockstar, I'm livin' like a rockstar (Ayy)
\n
\n[Chorus: Post Malone & 21 Savage]
\nI've been fuckin' hoes and poppin' pillies
\nMan, I feel just like a rockstar (Star, ayy, ayy)
\nAll my brothers got that gas
\nAnd they always be smokin' like a Rasta ('Sta, yeah, yeah, yeah, yeah)
\nFuckin' with me, call up on a Uzi
\nAnd show up, man, them the shottas ('Tas)
\nWhen my homies pull up on your block
\nThey make that thing go grrra-ta-ta-ta (Ta, grrra-ta-ta-ta-ta)
\n
\n[Outro: Post Malone]
\nStar, star, rockstar, rockstar, star
\nRockstar
\nRockstar, feel just like a–
\nRockstar
\nRockstar
\nRockstar
\nFeel just like a...
\n\n",
"artists": [
{
"url": "https://genius.com/artists/Post-malone",
"id": 326362,
"name": "Post Malone",
"imageUrl": "https://images.genius.com/6771553aba28386ce3b7ee55724d43c2.1000x1000x1.jpg",
"isVerified": true
}
],
"albums": [
{
"albumId": 326339,
"albumName": "beerbongs & bentleys",
"coverArtThumbnailUrl": "https://images.genius.com/ef176757a5735c7a104dd735543c1d20.300x300x1.png",
"coverArt": "https://images.genius.com/ef176757a5735c7a104dd735543c1d20.1000x1000x1.png",
"title": "beerbongs & bentleys by Post Malone",
"url": "https://genius.com/albums/Post-malone/Beerbongs-bentleys"
}
],
"relatedSongs": [
{
"id": 2942139,
"url": "https://genius.com/Post-malone-rockstar-lyrics",
"title": "rockstar"
},
{
"id": 2961138,
"url": "https://genius.com/Post-malone-psycho-lyrics",
"title": "Psycho"
},
{
"id": 3007474,
"url": "https://genius.com/Post-malone-candy-paint-lyrics",
"title": "Candy Paint"
},
{
"id": 3627785,
"url": "https://genius.com/Post-malone-stay-lyrics",
"title": "Stay"
},
{
"id": 3646558,
"url": "https://genius.com/Post-malone-paranoid-lyrics",
"title": "Paranoid"
},
{
"id": 3646559,
"url": "https://genius.com/Post-malone-same-bitches-lyrics",
"title": "Same Bitches"
},
{
"id": 3646560,
"url": "https://genius.com/Post-malone-blame-it-on-me-lyrics",
"title": "Blame It On Me"
},
{
"id": 3646561,
"url": "https://genius.com/Post-malone-92-explorer-lyrics",
"title": "92 Explorer"
},
{
"id": 3646562,
"url": "https://genius.com/Post-malone-otherside-lyrics",
"title": "Otherside"
},
{
"id": 3646563,
"url": "https://genius.com/Post-malone-takin-shots-lyrics",
"title": "Takin’ Shots"
},
{
"id": 3646564,
"url": "https://genius.com/Post-malone-over-now-lyrics",
"title": "Over Now"
},
{
"id": 3646565,
"url": "https://genius.com/Post-malone-sugar-wraith-lyrics",
"title": "Sugar Wraith"
},
{
"id": 3646566,
"url": "https://genius.com/Post-malone-zack-and-codeine-lyrics",
"title": "Zack and Codeine"
},
{
"id": 3646567,
"url": "https://genius.com/Post-malone-jonestown-interlude-lyrics",
"title": "Jonestown (Interlude)"
},
{
"id": 3646568,
"url": "https://genius.com/Post-malone-better-now-lyrics",
"title": "Better Now"
},
{
"id": 3646569,
"url": "https://genius.com/Post-malone-spoil-my-night-lyrics",
"title": "Spoil My Night"
},
{
"id": 3646570,
"url": "https://genius.com/Post-malone-rich-and-sad-lyrics",
"title": "Rich & Sad"
},
{
"id": 3646571,
"url": "https://genius.com/Post-malone-ball-for-me-lyrics",
"title": "Ball For Me"
}
],
"producedBy": [
{
"id": 1112844,
"title": "Tank God",
"url": "https://genius.com/artists/Tank-god"
},
{
"id": 143754,
"title": "Louis Bell",
"url": "https://genius.com/artists/Louis-bell"
}
],
"writtenBy": [
{
"id": 1112844,
"title": "Tank God",
"url": "https://genius.com/artists/Tank-god"
},
{
"id": 1668463,
"title": "Carl Rosen",
"url": "https://genius.com/artists/Carl-rosen"
},
{
"id": 18047,
"title": "Joey Bada$$",
"url": "https://genius.com/artists/Joey-bada"
},
{
"id": 143754,
"title": "Louis Bell",
"url": "https://genius.com/artists/Louis-bell"
},
{
"id": 430404,
"title": "21 Savage",
"url": "https://genius.com/artists/21-savage"
},
{
"id": 326362,
"title": "Post Malone",
"url": "https://genius.com/artists/Post-malone"
}
],
"tags": [
{
"url": "https://genius.com/tags/atlanta-rap",
"isPrimary": false,
"name": "Atlanta Rap",
"id": 3636
},
{
"url": "https://genius.com/tags/cloud-rap",
"isPrimary": false,
"name": "Cloud Rap",
"id": 2916
},
{
"url": "https://genius.com/tags/pop-rap",
"isPrimary": false,
"name": "Pop Rap",
"id": 3970
},
{
"url": "https://genius.com/tags/pop",
"isPrimary": true,
"name": "Pop",
"id": 16
},
{
"url": "https://genius.com/tags/dark-pop",
"isPrimary": false,
"name": "Dark Pop",
"id": 2788
},
{
"url": "https://genius.com/tags/rap",
"isPrimary": true,
"name": "Rap",
"id": 1434
}
],
"headerImageUrl": "https://images.genius.com/fcea8961b4c35793ce051a4637990615.1000x1000x1.png",
"media": [
{
"url": "https://open.spotify.com/track/1OmcAT5Y8eg5bUPv9qJT4R",
"type": "audio",
"provider": "spotify",
"nativeUri": "spotify:track:1OmcAT5Y8eg5bUPv9qJT4R"
},
{
"url": "https://soundcloud.com/postmalone/rockstar-feat-21-savage",
"type": "audio",
"provider": "soundcloud",
"attribution": "postmalone"
},
{
"url": "http://www.youtube.com/watch?v=UceaB4D0jpo",
"type": "video",
"start": 12,
"provider": "youtube"
}
],
"customPerformances": [
{
"label": "Performance Rights",
"artists": [
{
"id": 551598,
"url": "https://genius.com/artists/Ascap",
"name": "ASCAP",
"isVerified": false,
"imageUrl": "https://images.genius.com/cd12f3f393d30794d4d085567fa6693e.900x900x1.jpg"
},
{
"id": 1138091,
"url": "https://genius.com/artists/Bmi",
"name": "BMI",
"isVerified": false,
"imageUrl": "https://images.genius.com/051b0a6beabf8a9eb8768e9f874a542f.1000x1000x1.jpg"
},
{
"id": 3203462,
"url": "https://genius.com/artists/Songview",
"name": "SongView",
"isVerified": false,
"imageUrl": "https://images.genius.com/046e3c633307e5fcd9ca85274270c867.600x600x1.jpg"
}
]
},
{
"label": "Publisher",
"artists": [
{
"id": 1710098,
"url": "https://genius.com/artists/Roba-music-publishing",
"name": "ROBA Music Publishing",
"isVerified": false,
"imageUrl": "https://images.genius.com/c3dad93b4d939b50666ecfb4d2740936.1000x1000x1.png"
},
{
"id": 1011919,
"url": "https://genius.com/artists/Bmg",
"name": "BMG",
"isVerified": false,
"imageUrl": "https://images.genius.com/d7674e632d4ffeb66c78b9a2ec56f32e.400x400x1.jpg"
},
{
"id": 2263295,
"url": "https://genius.com/artists/Felicimi",
"name": "Felicimi",
"isVerified": false,
"imageUrl": "https://assets.genius.com/images/default_avatar_300.png?1687811564"
},
{
"id": 2153218,
"url": "https://genius.com/artists/Sony-atv-allegro",
"name": "Sony/ATV Allegro",
"isVerified": false,
"imageUrl": "https://assets.genius.com/images/default_avatar_300.png?1687811564"
},
{
"id": 1615581,
"url": "https://genius.com/artists/Slaughter-gang",
"name": "Slaughter Gang",
"isVerified": false,
"imageUrl": "https://images.genius.com/49cc005d21e544b8337c2c6de25d41b2.670x670x1.png"
},
{
"id": 2234993,
"url": "https://genius.com/artists/Posty-publishing",
"name": "Posty Publishing",
"isVerified": false,
"imageUrl": "https://assets.genius.com/images/default_avatar_300.png?1687811564"
},
{
"id": 2248863,
"url": "https://genius.com/artists/Joeybad-publishing",
"name": "JoeyBad Publishing",
"isVerified": false,
"imageUrl": "https://assets.genius.com/images/default_avatar_300.png?1687811564"
},
{
"id": 1525200,
"url": "https://genius.com/artists/Electric-feel",
"name": "Electric Feel",
"isVerified": true,
"imageUrl": "https://images.genius.com/a34cb17853582bae96f6c3a6ed60abb2.200x200x1.png"
},
{
"id": 1544670,
"url": "https://genius.com/artists/Reservoir-media",
"name": "Reservoir Media",
"isVerified": false,
"imageUrl": "https://images.genius.com/63ea161392ca63c9f79015c93ad5d2f5.200x200x1.png"
},
{
"id": 1104563,
"url": "https://genius.com/artists/Universal-music-group",
"name": "Universal Music Group",
"isVerified": false,
"imageUrl": "https://images.genius.com/7b3fb2c00317cb2eb2453f9f4e7473d1.600x600x1.png"
},
{
"id": 647230,
"url": "https://genius.com/artists/Emi-april-music",
"name": "EMI April Music",
"isVerified": false,
"imageUrl": "https://assets.genius.com/images/default_avatar_300.png?1687811564"
},
{
"id": 992360,
"url": "https://genius.com/artists/Bmg-gold-songs",
"name": "BMG Gold Songs",
"isVerified": false,
"imageUrl": "https://assets.genius.com/images/default_avatar_300.png?1687811564"
},
{
"id": 88331,
"url": "https://genius.com/artists/Sony-music-entertainment",
"name": "Sony Music Entertainment",
"isVerified": false,
"imageUrl": "https://images.genius.com/2a8cce70d4827d126ecbbc648a8ad62f.1000x1000x1.png"
}
]
},
{
"label": "Recording Engineer",
"artists": [
{
"id": 1690048,
"url": "https://genius.com/artists/Lorenzo-cardona",
"name": "Lorenzo Cardona",
"isVerified": false,
"imageUrl": "https://assets.genius.com/images/default_avatar_300.png?1687811564"
},
{
"id": 1179666,
"url": "https://genius.com/artists/Ethan-stevens",
"name": "Ethan Stevens",
"isVerified": false,
"imageUrl": "https://images.genius.com/6a3a29d89cf2de59b5bb92ddba7fd78d.813x813x1.jpg"
},
{
"id": 143754,
"url": "https://genius.com/artists/Louis-bell",
"name": "Louis Bell",
"isVerified": false,
"imageUrl": "https://images.genius.com/e5e5ab07410bcde1d4bc916ee86f6ec1.727x727x1.jpg"
}
]
},
{
"label": "Studio Personnel",
"artists": [
{
"id": 1690048,
"url": "https://genius.com/artists/Lorenzo-cardona",
"name": "Lorenzo Cardona",
"isVerified": false,
"imageUrl": "https://assets.genius.com/images/default_avatar_300.png?1687811564"
},
{
"id": 143754,
"url": "https://genius.com/artists/Louis-bell",
"name": "Louis Bell",
"isVerified": false,
"imageUrl": "https://images.genius.com/e5e5ab07410bcde1d4bc916ee86f6ec1.727x727x1.jpg"
},
{
"id": 1179666,
"url": "https://genius.com/artists/Ethan-stevens",
"name": "Ethan Stevens",
"isVerified": false,
"imageUrl": "https://images.genius.com/6a3a29d89cf2de59b5bb92ddba7fd78d.813x813x1.jpg"
},
{
"id": 635518,
"url": "https://genius.com/artists/Manny-marroquin",
"name": "Manny Marroquin",
"isVerified": false,
"imageUrl": "https://images.genius.com/312dc5aab4cf9f3040fc0e2fd05a9034.661x539x1.jpg"
}
]
},
{
"label": "Phonographic Copyright ℗",
"artists": [
{
"id": 1104563,
"url": "https://genius.com/artists/Universal-music-group",
"name": "Universal Music Group",
"isVerified": false,
"imageUrl": "https://images.genius.com/7b3fb2c00317cb2eb2453f9f4e7473d1.600x600x1.png"
},
{
"id": 1011844,
"url": "https://genius.com/artists/Republic-records",
"name": "Republic Records",
"isVerified": false,
"imageUrl": "https://images.genius.com/d8ea37a285aa8bdcb0eaebb31f116529.1000x1000x1.jpg"
}
]
},
{
"label": "Copyright ©",
"artists": [
{
"id": 1104563,
"url": "https://genius.com/artists/Universal-music-group",
"name": "Universal Music Group",
"isVerified": false,
"imageUrl": "https://images.genius.com/7b3fb2c00317cb2eb2453f9f4e7473d1.600x600x1.png"
},
{
"id": 1011844,
"url": "https://genius.com/artists/Republic-records",
"name": "Republic Records",
"isVerified": false,
"imageUrl": "https://images.genius.com/d8ea37a285aa8bdcb0eaebb31f116529.1000x1000x1.jpg"
}
]
},
{
"label": "Instrumentation",
"artists": [
{
"id": 1112844,
"url": "https://genius.com/artists/Tank-god",
"name": "Tank God",
"isVerified": true,
"imageUrl": "https://images.genius.com/cfd791d27335fe4442ba1aaee85cac99.1000x1000x1.jpg"
},
{
"id": 143754,
"url": "https://genius.com/artists/Louis-bell",
"name": "Louis Bell",
"isVerified": false,
"imageUrl": "https://images.genius.com/e5e5ab07410bcde1d4bc916ee86f6ec1.727x727x1.jpg"
}
]
},
{
"label": "Programmer",
"artists": [
{
"id": 1112844,
"url": "https://genius.com/artists/Tank-god",
"name": "Tank God",
"isVerified": true,
"imageUrl": "https://images.genius.com/cfd791d27335fe4442ba1aaee85cac99.1000x1000x1.jpg"
},
{
"id": 143754,
"url": "https://genius.com/artists/Louis-bell",
"name": "Louis Bell",
"isVerified": false,
"imageUrl": "https://images.genius.com/e5e5ab07410bcde1d4bc916ee86f6ec1.727x727x1.jpg"
}
]
},
{
"label": "Mixing Engineer",
"artists": [
{
"id": 635518,
"url": "https://genius.com/artists/Manny-marroquin",
"name": "Manny Marroquin",
"isVerified": false,
"imageUrl": "https://images.genius.com/312dc5aab4cf9f3040fc0e2fd05a9034.661x539x1.jpg"
}
]
},
{
"label": "Label",
"artists": [
{
"id": 1011844,
"url": "https://genius.com/artists/Republic-records",
"name": "Republic Records",
"isVerified": false,
"imageUrl": "https://images.genius.com/d8ea37a285aa8bdcb0eaebb31f116529.1000x1000x1.jpg"
}
]
},
{
"label": "Mastering Engineer",
"artists": [
{
"id": 647414,
"url": "https://genius.com/artists/Mike-bozzi",
"name": "Mike Bozzi",
"isVerified": false,
"imageUrl": "https://images.genius.com/0ec0a44b755cb745add8e3b72754a630.400x400x1.jpg"
}
]
},
{
"label": "Artwork",
"artists": [
{
"id": 1221286,
"url": "https://genius.com/artists/Dario-alva",
"name": "Darío Alva",
"isVerified": false,
"imageUrl": "https://assets.genius.com/images/default_avatar_300.png?1687811564"
},
{
"id": 223628,
"url": "https://genius.com/artists/Bryan-rivera",
"name": "Bryan Rivera",
"isVerified": false,
"imageUrl": "https://assets.genius.com/images/default_avatar_300.png?1687811564"
},
{
"id": 1025904,
"url": "https://genius.com/artists/Travis-brothers",
"name": "Travis Brothers",
"isVerified": false,
"imageUrl": "https://assets.genius.com/images/default_avatar_300.png?1687811564"
}
]
},
{
"label": "Video Director",
"artists": [
{
"id": 665888,
"url": "https://genius.com/artists/Emil-nava",
"name": "Emil Nava",
"isVerified": false,
"imageUrl": "https://images.genius.com/2bcafa68624001dbcd4ee853afdbe4e0.469x469x1.jpg"
}
]
},
{
"label": "Video Director Of Photography",
"artists": [
{
"id": 1265422,
"url": "https://genius.com/artists/Kramer-morgenthau",
"name": "Kramer Morgenthau",
"isVerified": false,
"imageUrl": "https://assets.genius.com/images/default_avatar_300.png?1687811564"
}
]
}
],
"contributors": [
{
"id": 30939,
"iq": 28111,
"url": "https://genius.com/TheDon",
"role": "editor",
"name": "TheDon",
"avatarUrl": "https://images.genius.com/avatars/medium/fb2e0b677bf61fcc2e8b8a9fb49f0b53",
"summary": "Fan of UK and US rap. Appreciate great bars and lyricism, but also enjoy the occasional Future and Gucci Mane. You’ll see me annotating mainly on UK artists because those are the bars I find easiest to decipher, or transcribing new songs, along with the occasional American annotations.\n\nFavourite rappers: Nas, Kendrick Lamar, The Notorious B.I.G., Lil Wayne,Wiley, Skepta, Kano, Dave, Lowkey\n\nFavourite artists: Kid Cudi, Kanye West, Travis Scott, Future, Young Thug\n\n(Yes, there is a difference between hip hop rappers and hip hop artists!)"
},
{
"id": 78276,
"iq": 87695,
"url": "https://genius.com/infiniteintellect",
"role": "contributor",
"name": "infiniteintellect",
"avatarUrl": "https://images.genius.com/avatars/medium/51ef21d60d5d0356fa62085e670f422c",
"summary": ""
},
{
"id": 271096,
"iq": 482485,
"url": "https://genius.com/Empath",
"role": "staff",
"name": "Colby Handy",
"avatarUrl": "https://images.genius.com/87b485555d6ecb9d5a6c2af59ac97dde.560x603x28.gif",
"summary": "Product @ Genius\n\nIf you need timely site support from staff, please reach out to @streetlights, @WriteNProppa, @killersnowtiger, @Gary, @louiedro, or @worstofalltime instead of me.\n\nOtherwise, feel free to shoot me a message and say hi!\n\n❄️🐝\n\n\n\n\nLearn how to annotate, transcribe, add song facts, and earn roles by reading our guides.\nTag @transcribers for help with lyrics and @genius-editorial-board and @mentors for help with annotations.\nStay in touch with new site features and fun projects by following the Genius Updates forum.\nGet involved with other contributors by creating or joining discussions in the Music, Genius Ideas, and Genius Help forums, or joining the Genius community Discord. \nReport problems with the website in the Bugs forum."
},
{
"id": 1176499,
"iq": 22853,
"url": "https://genius.com/Ali_EmJay",
"role": "editor",
"name": "Ali_EmJay",
"avatarUrl": "https://images.genius.com/avatars/medium/fc9448911728ba0e110ffde7a37f769e",
"summary": "journalist / writer / translator\n\n\nEmail: Juwedy@Gmail.com \n\nIf I have rejected your tate/suggestion and wanna know why, feel free to send a message (or for anything else, I guess)\n\n\n\nMy Telegram Channel \n\nArtists I’ve helped get verified:\n- Suki Waterhouse\n- Sister\n- Ghostly Kisses\n- Coals\n- Havana"
},
{
"id": 1710294,
"iq": 201130,
"url": "https://genius.com/SpeckHelper",
"role": "moderator",
"name": "Austin Rotter",
"avatarUrl": "https://images.genius.com/avatars/medium/34770935d89496157e42990ae26e5acc",
"summary": "DM me if you need help!\n\n\n\n\nThe info below is primarily for me to track my contributions\n\n\n\n\nMilestones\n\nJoined Genius/First Tate: May 3, 2015 \nMade Editor: January 27, 2017 \n20,000 IQ: August 7, 2017 \n30,000 IQ: November 16, 2017 \n40,000 IQ: December 15, 2017 \n50,000 IQ: January 1, 2018 \nMade Moderator: February 15, 2018 \n75,000 IQ: March 6, 2018 \n100,000 IQ: September 13, 2018 \n150,000 IQ: September 6, 2019 \n175,000 IQ: August 6, 2020 \n200,000 IQ: December 4, 2022\n\n\n\n\n\n\nMost Popular Transcriptions (>250k)\n\nPost Malone ft. Ty Dolla $ign -- \"Psycho\" (3,070,000) \nPost Malone & Swae Lee -- \"Sunflower\" (2,450,000) \nEminem -- \"Kamikaze\" (2,150,000) \nPost Malone -- \"Circles\" (1,860,000) \nThe Weeknd & Kendrick Lamar -- \"Pray For Me\" (1,120,000) \nPost Malone ft. Young Thug -- \"Goodbyes\" (1,080,000) \nMarshmello & Lil Peep -- \"Spotlight\" (830,000) \nPost Malone ft. Ozzy Osbourne & Travis Scott -- \"Take What You Want\" (755,000) \nPost Malone -- \"Over Now\" (735,000) \nNF -- \"Lie\" (635,000) \nBig Sean & Metro Boomin -- \"So Good\" (610,000) \nJ. Cole -- \"BRACKETS\" (550,000) \nMigos ft. Post Malone -- \"Notice Me\" (520,000) \nLogic -- \"Confessions of a Dangerous Mind\" (495,000) \nPost Malone -- \"92 Explorer\" (485,000) \nDrake -- \"Peak\" (440,000) \nPost Malone ft. Swae Lee -- \"Spoil My Night\" (425,000) \nDrake ft. Ty Dolla $ign -- \"After Dark\" (405,000) \nEminem -- \"Remind Me\" (355,000) \nMigos & Marshmello -- \"Danger\" (320,000) \n21 Savage ft. Post Malone -- \"all my friends\" (317,000) \nPost Malone -- \"Blame It On Me\" (315,000) \nPost Malone & The Weeknd -- \"One Right Now\" (300,000) \nTravis Scott & Quavo -- \"Motorcycle Patches\" (280,000)\n\n\n\n\n\n\nMiscellaneous\n\n \nMonthly Awards \nGenius of the Month (February 2018) \nBest Annotation of June 2019 \nBest Annotation of July 2019 \n13th Best Annotation of 2019 \nArticles \nRATL beerbongs & bentleys \nPost Malone's Stoney sets new record \nMarshmello x Fortnite Concert \nNF Reflects On Fame With \"The Search\" \nRATL Hollywood's Bleeding\n\n\n\n\n\n\nCommunity List Blurbs\n\n \nYear-End Best of 2017 \nStoney by Post Malone | \"rockstar\" by Post Malone \nMost Anticipated Albums of 2018 \nbeerbongs & bentleys by Post Malone \nMid-Year Best of 2018 \nbeerbongs & bentleys by Post Malone | \"Psycho\" by Post Malone | \"FRIENDS\" by Marshmello & Anne-Marie \nYear-End Best of 2018 \nbeerbongs & bentleys by Post Malone | \"Psycho\" by Post Malone | \"Nice For What\" by Drake \n100 Best Albums of the 2010s \nStoney by Post Malone \nYear-End Best of 2019 \nHollywood's Bleeding by Post Malone"
},
{
"id": 1743222,
"iq": 54596,
"url": "https://genius.com/gone_11d2u_aa7b",
"role": "contributor",
"name": "gone_11d2u_aa7b",
"avatarUrl": "https://assets.genius.com/images/default_avatar_300.png?1687811564",
"summary": ""
},
{
"id": 1827058,
"iq": 79613,
"url": "https://genius.com/NSRE",
"role": "editor",
"name": "NSRE",
"avatarUrl": "https://images.genius.com/avatars/medium/7efded331d43d35f109d196bb9db7291",
"summary": "A few achievements on Genius that I’m proud of:\n\n#1 Annotation June 2018\n#2 Annotation September 2018\n\nGetting my tates featured in these articles:\n\n\nWhat Does Frank Ocean’s “I Got Two Versions” Line Mean?\nNicki Minaj Has More To Say About Remy Ma & Papoose On DJ Khaled’s “I Can’t Even Lie”. Pretty sure Complex also lifted the tate\nThe Weeknd Appears To Sing About His Ex-Girlfriend Bella Hadid On “Wasted Times”.\nNAV Escalates His Beef With ‘XXL’ Following His “Freshman List” Song.\nMigos Reunite With Drake On Their New ‘Culture II’ Song “Walk It Talk It”.\nLil Wayne Showcases His Influence With Barack Obama & 2 Chainz Samples On “Dedicate”\n\n\n\nTates I heavily contributed to featured in:\n\n\nChris Brown & Joyner Lucas’ “Stranger Things” Samples The Hit Netflix Show’s Theme Song\nHow ‘Black Panther: The Album’ Connects With The Plot Of The Film\nDrake and Lil Wayne Both Reference The Cash Money Lawsuit On Their New “Family Feud” Remix\n\n\n\nHighest contributor score on My Dear, Melancholy, ye and Kids See Ghosts.\n\nShoulder-tapped by @ewokABdevito"
},
{
"id": 1837201,
"iq": 1802454,
"url": "https://genius.com/Qatarsi",
"role": "moderator",
"name": "Qatarsi",
"avatarUrl": "https://images.genius.com/avatars/medium/5aaca3dada7deba08627e6f87d6c683c",
"summary": "In claris non fit interpretatio.\n\nGenius Italia\n\n\n\n\n NB: Se elimino una tua annotazione e ti domandi il motivo, controlla meglio nelle notifiche: la risposta è già lì. Se continua a non tornarti qualcosa, dai un'occhiata alle regole di Genius relative alle annotazioni.\n\n\n\n\nOFF LYRICS IG\n\nOFF LYRICS YT"
},
{
"id": 2032874,
"iq": 26670,
"url": "https://genius.com/Hedi98",
"role": "contributor",
"name": "Hedi98",
"avatarUrl": "https://s3.amazonaws.com/filepicker-images-rapgenius/posgijpegt",
"summary": "#4 Chris Brown\n20K IQ Hit -15/07/18"
},
{
"id": 2793634,
"iq": 348673,
"url": "https://genius.com/WiktorFraniak",
"role": "editor",
"name": "WiktorFraniak",
"avatarUrl": "https://s3.amazonaws.com/filepicker-images-rapgenius/1nh2k3e2wxf",
"summary": "Siema! ;D Jestem Wiktor i od września 2016 działam tutaj jako editor i członek ekipy RGPL. Jeśli masz jakieś pytania, problemy – napisz do mnie, a chętnie ci pomogę.\n\n \n\n\n\nInstagram\nlast.fm\n\nWhosampled"
},
{
"id": 2962216,
"iq": 67217,
"url": "https://genius.com/lxns",
"role": "editor",
"name": "lxns",
"avatarUrl": "https://images.genius.com/avatars/medium/7dc1da168560a92ebaa8f0adb58b4be2",
"summary": "Mostly inactive, but I’ll clean up inaccurate info if I come across it."
},
{
"id": 3025667,
"iq": 2791,
"url": "https://genius.com/Yeezari",
"role": "verified_artist",
"name": "Yeezari",
"avatarUrl": "https://images.genius.com/avatars/medium/10d4ee01a7f1d2ecfba3aa826ce9fa41",
"summary": "Once a young and upcoming rapper from Sydney, Yeezari was an Australian-Iranian rapper with dynamic flows and rhyme schemes.\n\nThis versatility was evident, from tracks like “Big"
},
{
"id": 3409147,
"iq": 65772,
"url": "https://genius.com/AndyBelt",
"role": "editor",
"name": "AndyBelt",
"avatarUrl": "https://images.genius.com/avatars/medium/93d8bb7265364dffedebfbd22c0f8e96",
"summary": "Music Fanatic (occasional Zealot)"
},
{
"id": 4478046,
"iq": 38180,
"url": "https://genius.com/DennisTheTennis",
"role": "editor",
"name": "DennisTheTennis",
"avatarUrl": "https://s3.amazonaws.com/filepicker-images-rapgenius/jEWnphclRxy6e0Etciin_jay-z-nas-2013-04-10-300x300.jpg",
"summary": "If you have any questions, feel free to shoot me a message!"
},
{
"id": 4670710,
"iq": 239794,
"url": "https://genius.com/MrBroezzz",
"role": "editor",
"name": "MrBroezzz",
"avatarUrl": "https://images.genius.com/avatars/medium/78ee8a5cd03cc4e7c7d96532cb70a413",
"summary": "Dutch-English-French-German | 24 |\n\nIf you have a question, DM me!"
},
{
"id": 4796740,
"iq": 997,
"url": "https://genius.com/SCARXX",
"role": "contributor",
"name": "SCARXX",
"avatarUrl": "https://images.genius.com/avatars/medium/5f8387df5a63c8fee55bf229e7df8b69",
"summary": "I listen to Hip-Hop (Scarlxrd, Comethazine, Members Only, D Savage and more)"
},
{
"id": 5243064,
"iq": 38451,
"url": "https://genius.com/Lockshores",
"role": "moderator",
"name": "Victor R.",
"avatarUrl": "https://images.genius.com/avatars/medium/57e8bbe32504d40059d5110502a5696b",
"summary": "Genius France"
},
{
"id": 5310932,
"iq": 59625,
"url": "https://genius.com/RobMilli",
"role": "editor",
"name": "RobMilli",
"avatarUrl": "https://s3.amazonaws.com/filepicker-images-rapgenius/n0b09h91i9s",
"summary": "Milestones\n\nJoined Genius – 10/12/17\n1,000 IQ – 6/28/18\n5,000 IQ – 8/5/18\nTate Featured In Article – 8/20/18\n10,000 IQ – 8/22/18\nBest Annotations of August 2018 – 9/3/18\n15,000 IQ – 9/13/18\n20,000 IQ – 10/4/18\nTate Linked In Article – 10/13/18\n25,000 IQ – 10/27/18\nTate Written Out In Article – 11/2/18\nTate Featured In Article – 11/21/18\n30,000 IQ – 11/22/18\nTate Mentioned In Article – 11/22/18\nEditor and Rookie of the Year – 12/12/18\n40,000 IQ – 1/3/19\n50,000 IQ – 3/1/20\nGot a Real Life – 3/2/20\n\n \n\n\nFavorite Albums of All Time\n\n-The Marshall Mathers LP\n-My Dear Melancholy,\n-Illmatic\n-CARE FOR ME\n-Victory Lap\n-B4.DA.$$\n-The Eminem Show\n-Views\n-The Infamous\n-Feed tha Streets II\n-1999\n-KOD\n-Lifestylez ov da Poor & Dangerous\n-Savage Mode\n-The Slim Shady LP\n-Signed To The Streets 3\n-2014 Forest Hills Drive\n-Slauson Boy 2\n-Artist\n\n \n\n\nEditor\n\nBecame an Editor on 7/23/18 (Special thanks to @EwokABdevito, @IoShady, and @VinylZombie_MCR)"
},
{
"id": 5754203,
"iq": 30341,
"url": "https://genius.com/jochnrochn",
"role": "editor",
"name": "jochnrochn",
"avatarUrl": "https://s3.amazonaws.com/filepicker-images-rapgenius/oswtdtcz7y",
"summary": ""
},
{
"id": 6393487,
"iq": 166,
"url": "https://genius.com/BigDashie",
"role": null,
"name": "BigDashie",
"avatarUrl": "https://s3.amazonaws.com/filepicker-images-rapgenius/tm9ztkjudg",
"summary": "I listen to hella hip hop music."
},
{
"id": 6790749,
"iq": 71849,
"url": "https://genius.com/FinoyElegante",
"role": "editor",
"name": "FinoyElegante",
"avatarUrl": "https://images.genius.com/avatars/medium/44a890c24797c98e18ea5f7cdd69d3f6",
"summary": ""
},
{
"id": 9710542,
"iq": 22802,
"url": "https://genius.com/xsoul",
"role": "transcriber",
"name": "x$oul",
"avatarUrl": "https://images.genius.com/84350513d7dde46bbf842bca644d910d.320x320x1.jpg",
"summary": "pt & eng\n\n\n\n\n916\n\n\n\n\n\n\nAll my Transcriptions\n What I Listen to\n\nSocials\n\n\n\nImportant Dates:\n\n\n\n\n \nAccount Created – November 7, 2019 \n1,000 IQ – May 1, 2021 \n5,000 IQ – November 17, 2021 \n\nTranscriber – February 14, 2022 \n10,000 IQ – March 4, 2022 \n15,000 IQ – April 13, 2022 \n20,000 IQ – December 17, 2022 \n\n\n\n\n\nSome of my favorite artists:\n\n\n\n➭ 916frosty\n➭ Yeat\n➭ 1nonly\n➭ $UICIDEBOY$\n➭ Shady Moon\n➭ lilbubblegum\n\n\n\n✧ Special thanks to Coolrrrray for the mentoring & CG7777 + Ferb for granting me the Transcriber role!"
},
{
"name": "Aaditya",
"avatarUrl": "https://assets.genius.com/images/default_avatar_300.png?1687811564"
}
],
"pageviews": "7132655",
"isInTop10": false,
"isArtistInTop10": false,
"isAlbumInTop10": false,
"isNewRelease": false,
"isInTop10Rap": false,
"isInTop10Rock": false,
"isInTop10Country": false,
"isInTop10RnB": false,
"isInTop10Pop": false,
"title": "rockstar",
"primaryArtist": "Post Malone",
"primaryArtistId": 326362,
"createdAt": "2016-12-28T00:44:11Z",
"songTier": "D",
"releaseDate": "2017-09-15",
"commentCount": 371,
"isHot": false
}
```
### Contact
Please visit us through [epctex.com](https://epctex.com) to see all the products that are available for you. If you are looking for any custom integration or so, please reach out to us through the chat box in [epctex.com](https://epctex.com). In need of support? is at your service.
# Actor input Schema
## `startUrls` (type: `array`):
URLs to start with. It should be list or detail URL
## `search` (type: `string`):
The keyword that you can search on Genius
## `searchMode` (type: `string`):
What type of search do you want to make at Genius.
## `includeComments` (type: `boolean`):
Should comments be included in songs.
## `maxItems` (type: `integer`):
Maximum number of listing items that you want as output. Default is all
## `endPage` (type: `integer`):
The page number that you want to end with. By default there is no end page. This is applies to all search request and startUrls individually.
## `extendOutputFunction` (type: `string`):
Function that takes a JQuery handle ($) as argument and returns data that will be merged with the default output
## `customMapFunction` (type: `string`):
Function that takes each of the objects as argument and returns data that will be mapped by the function itself.
## `proxy` (type: `object`):
Select proxies to be used by your crawler.
## Actor input object example
```json
{
"startUrls": [
"https://genius.com/Fifty-fifty-cupid-twin-version-lyrics",
"https://genius.com/albums/Fifty-fifty/The-beginning-cupid",
"https://genius.com/artists/Drake",
"https://genius.com/tags/pop",
"https://genius.com/search?q=tiktok"
],
"search": "rap",
"searchMode": "song",
"includeComments": false,
"maxItems": 20,
"endPage": 1,
"extendOutputFunction": "($) => { return {} }",
"customMapFunction": "(object) => { return {...object} }",
"proxy": {
"useApifyProxy": true
}
}
```
# 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 = {
"startUrls": [
"https://genius.com/Fifty-fifty-cupid-twin-version-lyrics",
"https://genius.com/albums/Fifty-fifty/The-beginning-cupid",
"https://genius.com/artists/Drake",
"https://genius.com/tags/pop",
"https://genius.com/search?q=tiktok"
],
"search": "rap",
"searchMode": "song",
"maxItems": 20,
"endPage": 1,
"extendOutputFunction": ($) => { return {} },
"customMapFunction": (object) => { return {...object} },
"proxy": {
"useApifyProxy": true
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("epctex/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 = {
"startUrls": [
"https://genius.com/Fifty-fifty-cupid-twin-version-lyrics",
"https://genius.com/albums/Fifty-fifty/The-beginning-cupid",
"https://genius.com/artists/Drake",
"https://genius.com/tags/pop",
"https://genius.com/search?q=tiktok",
],
"search": "rap",
"searchMode": "song",
"maxItems": 20,
"endPage": 1,
"extendOutputFunction": "($) => { return {} }",
"customMapFunction": "(object) => { return {...object} }",
"proxy": { "useApifyProxy": True },
}
# Run the Actor and wait for it to finish
run = client.actor("epctex/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 '{
"startUrls": [
"https://genius.com/Fifty-fifty-cupid-twin-version-lyrics",
"https://genius.com/albums/Fifty-fifty/The-beginning-cupid",
"https://genius.com/artists/Drake",
"https://genius.com/tags/pop",
"https://genius.com/search?q=tiktok"
],
"search": "rap",
"searchMode": "song",
"maxItems": 20,
"endPage": 1,
"extendOutputFunction": "($) => { return {} }",
"customMapFunction": "(object) => { return {...object} }",
"proxy": {
"useApifyProxy": true
}
}' |
apify call epctex/genius-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=epctex/genius-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Genius Scraper",
"description": "The Genius.com scraper extracts songs and lyrics from the platform. It fetches details from song, album, artist pages, supports tag-based retrieval, searches, and includes comments. Simplify accessing and analyzing music content from Genius.com.",
"version": "0.0",
"x-build-id": "P6AKOb5h2CVr5aBcF"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/epctex~genius-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-epctex-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/epctex~genius-scraper/runs": {
"post": {
"operationId": "runs-sync-epctex-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/epctex~genius-scraper/run-sync": {
"post": {
"operationId": "run-sync-epctex-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",
"required": [
"proxy"
],
"properties": {
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "URLs to start with. It should be list or detail URL",
"items": {
"type": "string"
}
},
"search": {
"title": "Search keyword",
"type": "string",
"description": "The keyword that you can search on Genius"
},
"searchMode": {
"title": "Search Mode",
"enum": [
"song",
"lyric"
],
"type": "string",
"description": "What type of search do you want to make at Genius.",
"default": "song"
},
"includeComments": {
"title": "Include comments",
"type": "boolean",
"description": "Should comments be included in songs.",
"default": false
},
"maxItems": {
"title": "Maximum number of listing items",
"type": "integer",
"description": "Maximum number of listing items that you want as output. Default is all"
},
"endPage": {
"title": "List end page",
"type": "integer",
"description": "The page number that you want to end with. By default there is no end page. This is applies to all search request and startUrls individually."
},
"extendOutputFunction": {
"title": "Extend output function",
"type": "string",
"description": "Function that takes a JQuery handle ($) as argument and returns data that will be merged with the default output"
},
"customMapFunction": {
"title": "Custom map function",
"type": "string",
"description": "Function that takes each of the objects as argument and returns data that will be mapped by the function itself."
},
"proxy": {
"title": "Proxy configuration",
"type": "object",
"description": "Select proxies to be used by your crawler."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```