Chartmetric Search
Search tracks, albums, artists, curators, playlists, stations, cities, songwriters, and more with a single query. Also accepts DSP URLs (Spotify, Apple Music, Deezer, etc.). The shape below is the default (type=all) response; narrowing via type=artists|tracks|playlists|... returns only the matching bucket. Enabling beta=true switches to the beta global-search engine which returns suggestions entries instead.
Request
- Base URLhttps://api.chartmetric.com
- AuthHTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
Search query. Free text matched across artists, tracks, albums, playlists, curators, stations, cities, and songwriters; or a streaming/social URL to look up a single entity by its native ID.
Maximum number of items to return per request.
Number of items to skip from the start of the result set; pair with limit to paginate.
Restrict the search to a single entity bucket. One of all, artists, tracks, playlists, curators, albums, stations, cities, songwriters. Defaults to all.
If true, use the beta global-search engine which returns a flat suggestions list with match_strength and target per item instead of bucketed results.
Restrict beta search to these platforms. Only valid when beta=true. One or more of cm, spotify, itunes, applemusic, deezer, amazon, youtube, tidal, soundcloud, acr.
If true, restrict city results to Chartmetric Trigger Cities. Available for both beta and non-beta search.
Response
Success
Changes
No recorded changes to this operation across all 1 revision of this API.