Chartmetric Social Search

​

Search artists, curators, radio/SiriusXM stations, and songwriters by their social media URLs. DSP links (Spotify, Apple Music, etc.) should be resolved via /api/{entity}/{type}/{id}/get-ids instead.

Query Parameters
  • url
    Type: string
    required

    Social media URL to resolve (Instagram, TikTok, X/Twitter, YouTube, Facebook, etc.). DSP links should be resolved via /api/{entity}/{type}/{id}/get-ids instead.

  • type
    Type: stringenum

    Restrict the search to a single entity type. One of all, artists, radio, siriusxm, songwriters, curators. Defaults to all.

    values
    • all
    • artists
    • radio
    • siriusxm
    • songwriters
    • curators
Responses
  • application/json
Request Example for get/api/search/social
curl 'https://api.chartmetric.com/api/search/social?url=&type=all' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "id": 2762,
      "type": "artist",
      "name": "Taylor Swift",
      "image_url": "https://i.scdn.co/image/ab67616100005174f173136b94ae2f75f49f8b2b"
    }
  ]
}

Success