GET
/search/suggestLightweight autocomplete for search boxes. Returns up to N results per type (tracks, artists, albums) in one call. Perfect for keystroke-level calls — small payloads, short cache, fires three upstream searches in parallel.
Rate limit
120 req/min
Caching
Cached for 5 minutes per query+types+limit combo.
Authentication
Send a
User-Agent header containing a contact email. See authentication.Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| query | string | required | Partial search query. Minimum 2 characters. Alias: q. |
| limit | integer | optional | Results per type. 1-10, default 5. |
| types | string | optional | Comma-separated types to include: tracks, artists, albums. Default: all three. |
Request
curl 'https://api.synkradio.co.uk/search/suggest?query=around%20the%20world' \
-H 'User-Agent: [email protected]'Try it
GETTry it
Sends a real requesthttps://api.synkradio.co.uk/search/suggest?query=daft%20punkResponse
200 application/json
{
"query": "daft",
"tracks": [
{
"id": 66609426,
"name": "Get Lucky (Radio Edit - feat. Pharrell Williams and Nile Rodgers)",
"artist": "Daft Punk",
"isrc": "USQX91300809",
"durationMs": 248000,
"cover": "https://api.synkradio.co.uk/cover?artist=Daft%20Punk&title=Get%20Lucky"
}
],
"artists": [
{
"id": 27,
"name": "Daft Punk",
"fans": 5159788,
"image": "https://api.synkradio.co.uk/artistimage?id=27"
}
],
"albums": [
{
"id": 6575789,
"title": "Random Access Memories",
"artist": "Daft Punk",
"trackCount": 13,
"cover": "https://api.synkradio.co.uk/cover?artist=Daft%20Punk&title=Random%20Access%20Memories"
}
]
}Response schema
| Field | Type | Example | Description |
|---|---|---|---|
| query | string | "daft" | |
| tracks | array<object> | 1 item | Tracklist for the release. |
| artists | array<object> | 1 item | |
| albums | array<object> | 1 item |