GET /search/all · SYNK Radio API

GET/search/all

One search across tracks, artists, albums and playlists. Each section is relevance-ranked, and topResult tells you the single most likely thing the user meant.

Rate limit

60 req/min

Caching

Cached 15 minutes per query and type combination.

Notes

Ranking blends name similarity with popularity, so an exact title match beats a more famous near-miss.
Every track includes previewUrl and rank, which the older search endpoints leave out.
topResult carries the type, the score and the full item, so you can jump straight to a result.

Authentication

Send a User-Agent header containing a contact email. See authentication.

Parameters

Name	Type	Required	Description
query	string	required	What to search for.
limit	integer	optional	Results per section, 1-25. Defaults to 5.
types	string	optional	Comma-separated list to narrow the search: tracks, artists, albums, playlists. Defaults to all four.

Request

curl 'https://api.synkradio.co.uk/search/all?query=around%20the%20world' \
  -H 'User-Agent: [email protected]'

Try it

GETTry it

Sends a real request

query · string · requiredlimit · integertypes · stringUser-Agent · header

https://api.synkradio.co.uk/search/all?query=daft%20punk&limit=3

Response

200 application/json

{
  "query": "daft punk",
  "types": [
    "tracks",
    "..."
  ],
  "topResult": {
    "type": "artist",
    "score": 135,
    "item": {
      "id": 27,
      "name": "Daft Punk",
      "image": "/media/images/images/artist/638e69b9caaf9f9f3f8826febea7b543/1000x1000-000000-80-0-0.jpg",
      "fans": 5205424,
      "albumCount": 39,
      "score": 135
    }
  },
  "total": 8,
  "tracks": [
    {
      "id": 136889400,
      "name": "Starboy",
      "artist": "The Weeknd",
      "artistId": 4050205,
      "album": "Starboy",
      "albumId": 14652356,
      "durationMs": 230000,
      "explicit": true,
      "isrc": "USUG11600976",
      "rank": 975897,
      "previewUrl": "https://cdnt-preview.dzcdn.net/api/1/1/3/c/1/0/3c19a82aeffd2f6f6adb63c4d8548e06.mp3?hdnea=exp=1789426786~acl=/api/1/1/3/c/1/0/3c19a82aeffd2f6f6adb63c4d8548e06.mp3*~data=user_id=0,application_id=42~hmac=9b69770177cf27e614d4d616f5efbbaf0a2f75e8840951c8dfc151f5cc272c89",
      "cover": "https://api.synkradio.co.uk/cover?artist=The%20Weeknd&title=Starboy",
      "score": 25
    },
    "..."
  ],
  "artists": [
    {
      "id": 27,
      "name": "Daft Punk",
      "image": "/media/images/images/artist/638e69b9caaf9f9f3f8826febea7b543/1000x1000-000000-80-0-0.jpg",
      "fans": 5205424,
      "albumCount": 39,
      "score": 135
    },
    "..."
  ],
  "albums": [
    {
      "id": 299205,
      "title": "Daft Club",
      "artist": "Daft Punk",
      "artistId": 27,
      "cover": "/media/images/images/cover/0416976ab8f3f32e0b447dd1b9b1e0cf/1000x1000-000000-80-0-0.jpg",
      "releaseDate": null,
      "recordType": "album",
      "explicit": true,
      "trackCount": 14,
      "genreId": 113,
      "score": 28.8
    },
    "..."
  ],
  "playlists": [
    {
      "id": 15747253801,
      "title": "Daft punk",
      "cover": "/media/images/images/playlist/d9954c1b30c0ee2045efa31b153b3551/1000x1000-000000-80-0-0.jpg",
      "trackCount": 6,
      "creator": "Arezki Zourdani",
      "public": true,
      "score": 111
    },
    "..."
  ]
}

Response schema

Field	Type	Example	Description
query	string	"daft punk"
types	array<string>	2 items
topResult	object	3 fields
total	number	8
tracks	array<object>	2 items	Tracklist for the release.
artists	array<object>	2 items
albums	array<object>	2 items
playlists	array<object>	2 items

Previous/search/albums Next/search/artist