GET
/search/lyricsFind a track from a line of its lyrics. Candidates come from a lyrics-body search and are then verified against the actual lyrics, so results are confirmed rather than guessed.
Rate limit
30 req/min
Caching
Cached 24 hours per phrase.
Notes
- Matching ignores case, punctuation and apostrophes, so a phrase typed without them still matches.
- Verified results include matchedLine and, where the full lyrics were fetched, lineNumber and totalLines.
- candidatesChecked tells you how many candidates were considered before filtering.
Authentication
Send a
User-Agent header containing a contact email. See authentication.Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| query | string | required | A line or phrase from the lyrics. Minimum 3 characters. |
| limit | integer | optional | Maximum results, 1-25. Defaults to 10. |
| verify | boolean | optional | verify=false skips confirmation. Faster, but results are unverified guesses. On by default. |
| snippet | boolean | optional | Include the matched line and its neighbours. On by default. |
Request
curl 'https://api.synkradio.co.uk/search/lyrics?query=around%20the%20world' \
-H 'User-Agent: [email protected]'Try it
GETTry it
Sends a real requesthttps://api.synkradio.co.uk/search/lyrics?query=is%20this%20the%20real%20lifeResponse
200 application/json
{
"query": "never gonna give you up",
"verified": true,
"candidatesChecked": 26,
"count": 2,
"results": [
{
"artist": "Why Don’t We",
"title": "Hooked",
"album": null,
"isrc": null,
"verified": true,
"matchSource": "upstream",
"lyricsProvider": "upstream",
"matchedLine": "I swear I'm never gonna give you up, up, up, up, up, up, up",
"geniusUrl": "https://upstream.com/Why-dont-we-hooked-lyrics",
"thumbnail": "https://images.upstream.com/55d1f81459a60cf89be3223f46e85fd6.300x300x1.jpg",
"snippet": [
"under your influence (Ah)",
"I swear I'm never gonna give you up, up, up, up, up, up, up",
"You"
]
},
{
"artist": "Yung Gravy",
"title": "Betty (Get Money)",
"album": null,
"isrc": null,
"verified": true,
"matchSource": "upstream",
"lyricsProvider": "upstream",
"matchedLine": "Never gonna give you up",
"geniusUrl": "https://upstream.com/Yung-gravy-betty-get-money-lyrics",
"thumbnail": "https://images.upstream.com/d8f65b667cb1f2c8367c8d3defca6c6d.300x300x1.png",
"snippet": [
"Never gonna give you up",
"Never gonna let you down",
"Never gonna run around and desert you",
"I'll never"
]
}
]
}Response schema
| Field | Type | Example | Description |
|---|---|---|---|
| query | string | "never gonna give you up" | |
| verified | boolean | true | |
| candidatesChecked | number | 26 | |
| count | number | 2 | |
| results | array<object> | 2 items |