Skip to main content

Documentation Index

Fetch the complete documentation index at: https://rocks.docs.rive.wtf/llms.txt

Use this file to discover all available pages before exploring further.

Every API key is tied to one IP. To apply for a key, DM southctrl on Discord.
Use the endpoint path below, replace the required params, and send Authorization: Bearer YOUR_API_KEY.

​
Quick Start

1

Search for a song

Use the title, artist, or supported query format in the route.
2

Call the lyrics endpoint

Send the request with your Bearer token.
3

Use the lyrics

Read the returned text and metadata in your app.
Great for music bots and lyric search commands.

​
Search Lyrics

Search for song lyrics by song title and artist.

​
Endpoint

GET /api/lyrics

​
Query Parameters

​
q
string
required
Search query in format “Song Title - Artist Name”.

​
Example Request

cURL
curl -X GET "https://rocks.rive.wtf/api/lyrics?q=Bohemian%20Rhapsody%20-%20Queen" \
  -H "Authorization: Bearer YOUR_API_KEY"
JavaScript
const response = await fetch('https://rocks.rive.wtf/api/lyrics?q=Bohemian%20Rhapsody%20-%20Queen', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);
Python
import requests

headers = {'Authorization': 'Bearer YOUR_API_KEY'}
params = {'q': 'Bohemian Rhapsody - Queen'}

response = requests.get(
    'https://rocks.rive.wtf/api/lyrics',
    headers=headers,
    params=params
)

print(response.json())

​
Example Response

{"lines":[{"line":"Is this the real life? Is this just fantasy?","range":{"start":120}},{"line":"Caught in a landslide, no escape from reality","range":{"start":6540}},{"line":"Open your eyes, look up to the skies and see","range":{"start":14600}},{"line":"I'm just a poor boy, I need no sympathy","range":{"start":25180}}
Use URL encoding for spaces and special characters in the query parameter.
Lyrics are provided for informational purposes only. All rights belong to their respective copyright holders.