geniURL-Mirror

geniURL

Simple "REST proxy" for searching for lyrics on genius.com

Routes:

GET /search?q=<text>

This endpoint searches the genius API for the specified <text>
The text should contain both song and artist name(s) if possible, but the song name alone might sometimes be enough.
If there are special characters, they need to be percent/URL-encoded.

Successful response (click to view)

{
    "error": false,
    "top": {
        "url": "https://genius.com/Artist-1-song-name-lyrics",
        "path": "/Artist-1-song-name-lyrics",
        "meta": {
            "title": "Song Name",
            "fullTitle": "Song Name by Artist 1 (ft. Artist 2)",
            "artists": "Artist 1 (ft. Artist 2)",
            "primaryArtist": {
                "name": "Artist 1",
                "url": "https://genius.com/artists/Artist-1"
            }
        },
        "resources": {
            "thumbnail": "https://images.genius.com/8485557225af0345d2c550af8bae731b.300x300x1.png",
            "image": "https://images.genius.com/13d7b13ef827a9f007a5d24c115b9ebb.1000x1000x1.png"
        },
        "lyricsState": "complete",
        "id": 42069
    },
    "all": [
        /* 10 elements, same structure as "top", sorted best match first */
    ],
    "timestamp": 1234567890123
}

Errored response (click to view)

{
    "error": true,
    "message": "Something went wrong",
    "timestamp": 1234567890123
}