Skip to main content

​
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())

​
Response Example

{"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.