README.md 1.6 KB
lang: en-US title: Guide
description: Get started with using geniURL to fetch lyrics metadata
Introduction
geniURL is a simple JSON and XML REST API to search for song metadata, the lyrics URL and lyrics translations on genius.com.
Authorization is not required and geniURL implements a fuzzy search that will greatly improve search results over the genius.com API.
Obtaining actual lyrics sadly isn't possible.
Base URL
I host a public instance on this base URL:
https://api.sv443.net/geniurl/v2/
Rate Limiting
The public instance is rate limited to 25 requests within a 30 second timeframe.
To know how many requests you have sent and are still able to send, refer to the following headers that are attached to each response:
| Name | Description |
| :---------------------- | :-------------------------------------------------------------------------------------------------------------- |
| Retry-After | Number of seconds you need to wait until being able to send another request. |
| X-RateLimit-Reset | An ISO 8601 UTC timestamp indicating when you can send more requests. |
| X-RateLimit-Limit | The total number of requests you can send per timeframe. |
| X-RateLimit-Remaining | The requests you are still able to send in the current timeframe. |