Search
Search is the front door to your fully licensed catalogue in Tuned Global. One API powers everything from the primary search bar in your app to advanced editorial and production-music discovery, across every content type on the platform and the entities around it. Results come back ranked by relevance, real listening activity, and context, so the most useful matches surface first.
Every search endpoint lives on the Metadata API and needs only your API key, no user sign-in. That makes search fast, cacheable, and simple to wire up: the same query works for an anonymous visitor and a signed-in listener alike.
A note on relevance
Results are not a flat text match. The catalogue is ranked on three signals working together:
- Relevance: how closely a result matches the query
- Popularity: how much a result is actually played and engaged within your service
- Context: territory, availability, and the tags in play
The result is a search bar that surfaces the tracks people actually want, not just the ones whose titles happen to contain the query.
Millisecond response times across tens of millions of catalogue items, so your search feels instant however large the library grows.
What you can search
Everything under the search umbrella falls into a handful of families. Most integrations start with music content search and grow from there.
Search Family | What it covers | Typical use |
Songs, albums, artists, videos, playlists, and radio stations | The main search bar, and "search all" experiences that return mixed results | |
Podcasts, audiobooks, live video, and karaoke | Dedicated search and browse surfaces for spoken-word and video | |
Social discovery (find friends, public profiles) and tag-browsing experiences | ||
Songs filtered by musical attributes, not just text | Production-music search, mood and tempo discovery, editorial curation | |
Fuzzy matching on title, artist, ISRC, and duration | Reconciling an external catalogue against Tuned Global's | |
"Trending now" rails and understanding what your audience looks for |
Music content search
Full-text search across the core catalogue, ranked by relevance and shaped by real usage and context. Every result set can be filtered by content type, territory, and tags, and pages cleanly with an offset and count.
- Search all content types in a single call, optionally scoped to just the types you want (for example songs and albums only)
- Dedicated per-type search for songs, albums, artists, videos, playlists, and radio stations, when you want a focused result set
- Territory filtering so results respect what is licensed and available in the listener's country
- Consistent pagination across every endpoint, so one result-handling pattern works everywhere
Use unified search to power a primary search bar, and per-type search for tabbed or filtered result screens.
Advanced song search
Go beyond keywords and search songs by their musical characteristics. Advanced song search filters the catalogue on:
- Tempo (BPM range), musical key, and duration range
- Release year, decade, and a "released in the last 90 days" flag for new music
- Artist, album, label, and tags
- Mood and thematic attributes
This turns the catalogue into a discovery tool for admins, editorial teams, and production-music use cases, where "find upbeat tracks in A minor from the 1980s under three minutes" matters more than a text match.
Song matching
Match Songs performs a fuzzy lookup against the catalogue using a song title, artist name, duration, and ISRC. It is built for reconciliation rather than end-user search: line up an external catalogue, a fingerprint result, or a partner's metadata against Tuned Global's catalogue and resolve it to the right track in Tuned Global's database.
Beyond music
Spoken-word and video content each have their own search endpoints, scoped to a single content type and supporting the filters that make sense for that domain:
- Live video: search live channels and live shows
- Karaoke: search the karaoke catalogue
Use these when building dedicated browse or search surfaces for a single non-music content type.
Public profiles and tags
- User search powers social features such as finding public and verified user profiles.
- Tag search enables dynamic tag-browsing, letting listeners discover and apply genre or mood tags, and can be scoped to a specific tag type
Search intelligence
Search is also a signal. Every query your users run tells you what they want, and these endpoints turn that into insight and discovery surfaces:
- Log search terms as they happen, to build the picture below
- Top search terms: the most searched queries for your store
- Top searched products: the most searched items, grouped by type (songs, albums, artists)
- Trending artists: the artists with the most search momentum right now, ready for a "trending" rail
Built on the Metadata API
The entire Search surface is part of the Metadata API (version 2.4), authenticated with your API key and the StoreId header. No user token is involved, so search responses are anonymous, cacheable, and safe to serve from a CDN or an edge layer. This is the same access model as the rest of the public catalogue: you are reading the catalogue, not acting on behalf of a user.
Related capabilities elsewhere in the docs
Search leads into the rest of the catalogue:
- Playlists and Stations: search surfaces these too, and each has its own section for working with the result
- Tags: browse and apply the genre and mood tags that search can filter on (
Tags section)
On this page
- Search