Shazam Songs Discovery Actor

Overview

This actor searches the Shazam catalog for songs using keywords. It returns structured JSON data containing comprehensive metadata for each matching track, including artist details, album info, lyrics, audio previews, and related songs.

Key Features

• Song Search: Find tracks by song title, artist name, or other keywords.
• Rich Metadata: Returns song name, artist, genres, release date, duration, play count (Shazams), and cover art.
• Extended Content: Provides lyrics (when available), a short audio preview URL, and detailed artist profiles.
• Related Data: Includes lists of associated albums/playlists and similar songs.
• Credits: Supplies performer, songwriter, producer, and engineer credits.

How to Use

Configure the actor with a search query and a result limit. The actor will fetch and structure the data from Shazam.

Input

Run the actor with a JSON input like the following:

{
  "song_search": "bones, imagine dragons",
  "limit": 3
}

Input Parameters:
* song_search (string): Keywords for the song or artist (e.g., "Bones Imagine Dragons").
* limit (integer): The maximum number of results to return. Default is 3, maximum is 20. Use a lower limit for better performance.

Output

The actor outputs an array of song objects. Each object contains the following structure (some fields may be null if data is unavailable):

{
  "id": "1612321591",
  "link": "https://www.shazam.com/song/1612321591",
  "name": "Bones",
  "genres": ["Alternative", "Music"],
  "shazams": "7,485,173",
  "duration_in_ms": 165265,
  "image": "https://is1-ssl.mzstatic.com/image/thumb/...",
  "has_lyrics": true,
  "lyrics": "Gimme, gimme, gimme some time to think...",
  "album_name": "Bones - Single",
  "track_number": 1,
  "release_date": "2021-03-11",
  "preview": {
    "url": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview122/..."
  },
  "artist_info": {
    "id": "358714030",
    "name": "Imagine Dragons",
    "link": "https://www.shazam.com/artist/imagine-dragons/358714030",
    "image": "https://is1-ssl.mzstatic.com/image/thumb/..."
  },
  "albums": [
    {
      "id": "1612321587",
      "name": "Bones - Single",
      "artist": "Imagine Dragons",
      "image": "https://is1-ssl.mzstatic.com/image/thumb/...",
      "link": "https://www.shazam.com/album/1612321587/bones-single"
    }
  ],
  "similar_songs": [
    {
      "id": "1320781379",
      "name": "Beggin'",
      "artist": "Måneskin",
      "image": "https://is1-ssl.mzstatic.com/image/thumb/...",
      "link": "https://www.shazam.com/song/1320781379"
    }
  ]
}

Notes:
* For the most accurate results, use specific search queries.
* The availability of lyrics, similar songs, and other fields depends on Shazam's data.