dariusiii/php-itunes-api

Query iTunes API System

Maintainers

Details

github.com/DariusIII/php-itunes-api

Homepage

Source

Issues

Installs: 13 166

Dependents: 1

Suggesters: 0

Security: 0

Stars: 11

Watchers: 2

Forks: 4

Open Issues: 0

1.0.12 2025-01-20 14:21 UTC

Requires

Requires (Dev)

Apache-2.0 3b51e44cd7a6bb72a77d030f398d49d317805959

  • Jacopo Andrea Nuzzi <jacoz.woop@php.net>
  • DariusIII

apiqueryappleitunesmusicmovies

This package is auto-updated.

Last update: 2025-04-20 15:04:32 UTC

README

iTunes Query System

CircleCI

Requirements:

  • PHP >= 7.2

Installation:

With Composer:

{
    "require": {
        "dariusiii/php-itunes-api": "dev-master"
    }
}

Usage:

You can search artists, albums and tracks (by now)

<?php
use DariusIII\ItunesApi\iTunes;

$artistsFinder = iTunes::load('artist');
$albumsFinder = iTunes::load('album');
$tracksFinder = iTunes::load('track');
$moviesFinder = iTunes::load('movie');
$ebooksFinder = iTunes::load('ebook');

Finders' methods

Artists Finder
Method Return
fetchById( int $id [, string $country [, bool $includeAlbums ] ] ) Artist
fetchByName( string $name [, string $country ] ) SearchResults
fetchOneByName( int $id [, string $country [, bool $includeAlbums ] ] ) Artist
Albums Finder
Method Return
fetchById( int $id [, string $country [, bool $includeTracks ] ] ) Album
fetchByName( string $name [, string $country ] ) SearchResults
fetchOneByName( int $id [, string $country [, bool $includeTracks ] ] ) Album
Tracks Finder
Method Return
fetchById( int $id [, string $country ] ) Track
fetchByName( string $name [, string $country ] ) SearchResults
fetchOneByName( int $id [, string $country ] ) Track
Movies Finder
Method Return
fetchById( int $id [, string $country ] ) Movie
fetchByName( string $name [, string $country ] ) SearchResults
fetchOneByName( int $id [, string $country ] ) Movie
Ebooks Finder
Method Return
fetchById( int $id [, string $country ] ) Ebook
fetchByName( string $name [, string $country ] ) SearchResults
fetchOneByName( int $id [, string $country ] ) Ebook

Entities

Artist Entity
Attribute Type Description
itunesId integer -
name string -
albums Collection -
Album Entity
Attribute Type Description
itunesId integer -
artistId integer iTunes artist's ID
artistName string iTunes artist's Name
name string -
cover string URL to image
explicit bool -
tracksCount integer -
releaseDate DateTime -
tracks Collection -
Track Entity
Attribute Type Description
itunesId integer -
artistId integer iTunes artist's ID
albumId integer iTunes album's ID
name string -
artistName string iTunes artist's name
preview string URL to track's audio preview
explicit bool -
trackNumber integer -
length integer Track's lenght in milliseconds
cover string URL to track cover
Movie Entity
Attribute Type Description
itunesId integer -
artistId integer iTunes artist's ID
name string -
director string Movie director(s)
cover string URL to movie's cover
storeUrl string URL to movie's page
trailer string URL to movie's trailer
explicit bool -
description string Movie description
tagline string Movie tagline
releaseDate DateTime Movie release date
genre string Movie genre
Ebook Entity
Attribute Type Description
itunesId integer -
artistId integer iTunes artist's ID
name string -
author string Book author
cover string URL to ebook cover
storeUrl string URL to book's page
description string Book description
releaseDate DateTime Book release date
genre array Boook genre

Collections

Collection

A Collection is an ArrayObject

SearchResults

A SearchResults is an ArrayObject