2.5.4 Recherche par saison de série télévisée

GET /search/tvshows/seasons

Permet de rechercher dans la base de données de saisons de séries télévisées d'itunes.

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 Saw l'URL sera /search/tvshows/seasons?q=saw.

Paramètres facultatifs

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

genreId permet de chercher les saisons de série télévisée d'un genre en particulier. La valeur de l'id peut être obtenue par un appel à /genres/tvshows. Par exemple pour rechercher pour Saw de type Horror, l'URL sera /search/tvshows/seasons?q=saw&genreId=4408.

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

Sortie

{
    "resultCount": 2,
    "results": [
        {
            "wrapperType": "collection",
            "collectionType": "TV Season",
            "artistId": 278750007,
            "collectionId": 279175900,
            "artistName": "Rome",
            "collectionName": "Rome, Season 1",
            "collectionCensoredName": "Rome, Season 1",
            "artistViewUrl": "https://itunes.apple.com/us/tv-show/rome/id278750007?uo=4",
            "collectionViewUrl": "https://itunes.apple.com/us/tv-season/rome-season-1/id279175900?uo=4",
            "artworkUrl60": "http://is4.mzstatic.com/image/pf/us/r30/Video2/v4/8e/5d/67/8e5d6720-1da6-b8fa-d10e-262e2d68a482/mzl.lhhvljhw.60x60-50.jpg",
            "artworkUrl100": "http://is2.mzstatic.com/image/pf/us/r30/Video2/v4/8e/5d/67/8e5d6720-1da6-b8fa-d10e-262e2d68a482/mzl.lhhvljhw.100x100-75.jpg",
            "collectionPrice": 19.99,
            "collectionHdPrice": 29.99,
            "collectionExplicitness": "notExplicit",
            "contentAdvisoryRating": "TV-MA",
            "trackCount": 12,
            "copyright": "© 2005 Home Box Office, Inc.",
            "country": "USA",
            "currency": "USD",
            "releaseDate": "2008-05-12T07:00:00Z",
            "primaryGenreName": "Drama",
            "longDescription": "Every city has its secrets. HBO presents Season 1 of this epic series about generals and soldiers, masters and slaves, husbands and wives — all entwined in the furious historical events that saw the death of a republic and the birth of an empire. The season begins in 52 B.C. as Gaius Julius Caesar completes his quest of Gaul after eight years of war and prepares to return with his army to Rome. But while Caesar's self-interested niece Atia and long-lost paramour Servilia anxiously await his return, the ruling patricians despair that Caesar's homecoming will disrupt the status quo. As Caesar's legions move closer to Rome, allegiances are put to the test for both soldiers and civilians — and the escalating tensions climax with a full-scale conflict destined to change history. The ensemble cast includes Kevin McKidd, Ray Stevenson, Polly Walker, Kenneth Cranham, Tobias Menzies, James Purefoy, and Ciarán Hinds."
        },{...
    }]
}