Shazam · Example Payload

Recognize Response

MusicAudio RecognitionSong IdentificationChartsArtistsTracksFingerprinting

Recognize Response is an example object payload from Shazam, with 6 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

matcheslocationtimestamptimezonetagidtrack

Example Payload

Raw ↑ 
{
  "matches": [
    {
      "id": "549952578",
      "offset": 21.953,
      "timeskew": -0.000020257,
      "frequencyskew": -0.00046
    }
  ],
  "location": {
    "accuracy": 25
  },
  "timestamp": 1700000000000,
  "timezone": "America/New_York",
  "tagid": "c47d9fc2-4e39-4b88-b5b8-3b9d4e3cf4a3",
  "track": {
    "layout": "5",
    "type": "MUSIC",
    "key": "549952578",
    "title": "Blinding Lights",
    "subtitle": "The Weeknd",
    "isrc": "USUG12004076",
    "url": "https://www.shazam.com/track/549952578/blinding-lights",
    "images": {
      "background": "https://is1-ssl.mzstatic.com/image/thumb/Music124/v4/9a/19/93/9a19939a-6c33-31d3-09e4-1e41f3745f3e/source/800x800bb.jpg",
      "coverart": "https://is1-ssl.mzstatic.com/image/thumb/Music124/v4/9a/19/93/9a19939a-6c33-31d3-09e4-1e41f3745f3e/source/400x400bb.jpg",
      "coverarthq": "https://is1-ssl.mzstatic.com/image/thumb/Music124/v4/9a/19/93/9a19939a-6c33-31d3-09e4-1e41f3745f3e/source/800x800bb.jpg"
    },
    "share": {
      "subject": "Blinding Lights - The Weeknd",
      "text": "I used Shazam to discover Blinding Lights by The Weeknd.",
      "href": "https://www.shazam.com/track/549952578/blinding-lights",
      "image": "https://is1-ssl.mzstatic.com/image/thumb/Music124/v4/9a/19/93/9a19939a-6c33-31d3-09e4-1e41f3745f3e/source/400x400bb.jpg",
      "twitter": "I used @Shazam to discover Blinding Lights by The Weeknd.",
      "html": "https://www.shazam.com/snippets/email-share/549952578?lang=en-US&country=GB"
    },
    "hub": {
      "type": "APPLEMUSIC",
      "image": "https://images.shazam.com/static/icons/hub/web/v5/applemusic.png",
      "actions": [
        {
          "name": "apple",
          "type": "applemusicplay",
          "id": "1488408568"
        },
        {
          "name": "apple",
          "type": "uri",
          "uri": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview112/v4/example.m4a"
        }
      ],
      "providers": [
        {
          "caption": "Open in Spotify",
          "images": {
            "overflow": "https://images.shazam.com/static/icons/hub/web/v5/overflow-open-option.png",
            "default": "https://images.shazam.com/static/icons/hub/web/v5/spotify.png"
          },
          "actions": [
            {
              "name": "spotify",
              "type": "uri",
              "uri": "spotify:track:0VjIjW4GlUZAMYd2vXMi3b"
            }
          ]
        }
      ]
    },
    "sections": [
      {
        "type": "SONG",
        "metapages": [
          {
            "image": "https://is1-ssl.mzstatic.com/image/thumb/Music124/v4/9a/19/93/9a19939a-6c33-31d3-09e4-1e41f3745f3e/source/400x400bb.jpg",
            "caption": "The Weeknd"
          }
        ],
        "tabname": "Song",
        "metadata": [
          { "title": "Album", "text": "After Hours" },
          { "title": "Label", "text": "Republic Records/Cash Money" },
          { "title": "Released", "text": "2020" }
        ]
      }
    ]
  }
}