2.4.1 Recherche globale

GET /search

Permet de rechercher dans la base de données d'itunes les albums, chansons, artistes en un seul appel.

Entrée (query parameter)

Token d'authentification nécessaire

Paramètres obligatoires

q est le paramètre de recherche dans l'URL. Par exemple pour rechercher pour skrillex l'URL sera /search?q=skrillex.

Paramètres facultatifs

limit donne le nombre de résultats maximums voulu. (Valeur par défault de 10) Par exemple pour rechercher pour skrillex et obtenir maximum 20 résultats l'URL sera /search?q=skrillex&limit=20.

La requête doit être URL encodée (Comment URL encoder en JavaScript)

Sortie

{
    "resultCount": 10,
    "results": [
        {
            "wrapperType": "track",
            "kind": "song",
            "artistId": 356545647,
            "collectionId": 409001929,
            "trackId": 409001935,
            "artistName": "Skrillex",
            "collectionName": "Scary Monsters and Nice Sprites",
            "trackName": "Scary Monsters and Nice Sprites",
            "collectionCensoredName": "Scary Monsters and Nice Sprites",
            "trackCensoredName": "Scary Monsters and Nice Sprites",
            "artistViewUrl": "https://itunes.apple.com/us/artist/skrillex/id356545647?uo=4",
            "collectionViewUrl": "https://itunes.apple.com/us/album/scary-monsters-nice-sprites/id409001929?i=409001935&uo=4",
            "trackViewUrl": "https://itunes.apple.com/us/album/scary-monsters-nice-sprites/id409001929?i=409001935&uo=4",
            "previewUrl": "http://a1974.phobos.apple.com/us/r1000/115/Music/2a/79/01/mzm.uiaapnbf.aac.p.m4a",
            "artworkUrl30": "http://a2.mzstatic.com/us/r30/Features/18/a0/ad/dj.tjtxuafz.30x30-50.jpg",
            "artworkUrl60": "http://a4.mzstatic.com/us/r30/Features/18/a0/ad/dj.tjtxuafz.60x60-50.jpg",
            "artworkUrl100": "http://a3.mzstatic.com/us/r30/Features/18/a0/ad/dj.tjtxuafz.100x100-75.jpg",
            "collectionPrice": 7.99,
            "trackPrice": 1.29,
            "releaseDate": "2010-12-21T08:00:00Z",
            "collectionExplicitness": "explicit",
            "trackExplicitness": "notExplicit",
            "discCount": 1,
            "discNumber": 1,
            "trackCount": 9,
            "trackNumber": 2,
            "trackTimeMillis": 243354,
            "country": "USA",
            "currency": "USD",
            "primaryGenreName": "Dance",
            "radioStationUrl": "https://itunes.apple.com/station/idra.409001935"
        }, {
    }]
}