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.

Query Parameters

q
Type: string
max length:
100
required

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.
limit
Type: integer
min:
1
max:
100

Maximum number of items to return per request.
offset
Type: integer
min:
0

Number of items to skip from the start of the result set; pair with limit to paginate.
type
Type: string enum

Restrict the search to a single entity bucket. One of all, artists, tracks, playlists, curators, albums, stations, cities, songwriters. Defaults to all.
values
- all
- artists
- tracks
- playlists
- curators
- albums
- stations
- cities
- songwriters
beta
Type: boolean

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.
platforms
Type: array string[] enum

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.
values
- cm
- spotify
- itunes
- applemusic
- deezer
triggerCitiesOnly
Type: boolean

If true, restrict city results to Chartmetric Trigger Cities. Available for both beta and non-beta search.

Responses

application/json

get/api/search

curl 'https://api.chartmetric.com/api/search?q=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "obj": {
    "artists": [
      {
        "id": 3963,
        "name": "Ariana Grande",
        "image_url": "https://i.scdn.co/image/ab6761610000e5eb40b5c07ab77b6b1a9075fdc0",
        "isni": "0000000059110272",
        "sp_followers": 97135043,
        "sp_monthly_listeners": 80733093,
        "cm_artist_score": 495952
      }
    ],
    "playlists": {
      "spotify": [
        {
          "id": 741236,
          "name": "Ariana Grande: Best Of",
          "image_url": "https://i.scdn.co/image/ab67706c0000bebb4d5b3fbd576a2254f137f5e1",
          "owner_name": "arianagrandeofficial"
        }
      ],
      "applemusic": [],
      "deezer": [
        {
          "id": "1147053693",
          "name": "Ariana Grande Selection",
          "image_url": "https://api.deezer.com/playlist/1147053693/image",
          "owner_name": "Tigo El Salvador"
        }
      ],
      "amazon": [],
      "youtube": [],
      "soundcloud": []
    },
    "tracks": [
      {
        "id": "27590886",
        "name": "Ariana",
        "image_url": "https://i.scdn.co/image/9fa1a27e9e43b48a822e23285d1a13b64f74d311",
        "isrc": "GBKPL1977961",
        "artist_names": [
          "Tony Anderson"
        ]
      }
    ],
    "curators": {
      "spotify": [
        {
          "id": 59081,
          "name": "arianagrandeofficial",
          "image_url": null
        }
      ],
      "applemusic": [],
      "deezer": [],
      "amazon": [],
      "youtube": []
    },
    "albums": [
      {
        "id": 15091594,
        "name": "Ariana",
        "image_url": "https://i.scdn.co/image/ab67616d0000b2737b0314e32f28c3aa6bcab762",
        "label": "Dfideliz"
      }
    ],
    "stations": [],
    "labels": [],
    "cities": [
      {
        "id": 16166,
        "name": "Ariana",
        "name_ascii": "Ariana",
        "population": 97687,
        "country": "Tunisia",
        "code2": "TN",
        "province": null,
        "trigger_city": false
      }
    ],
    "countries": [],
    "songwriters": [
      {
        "name": "Nicole Ariana",
        "doc_id": 1564636,
        "artistName": "Nicole Ariana",
        "image_url": null
      }
    ],
    "genres": [],
    "festivals": []
  }
}

Success