omnisong/itunes API reference

Omnisong\Itunes

ItunesCatalog class

final class ItunesCatalog implements CatalogInterface ItunesCatalog.php:26

Apple's catalogue through the iTunes Search API (search and lookup, no key): a release by its UPC, an ISRC, an Apple Music URL or its id, with its tracks and their 30-second previews; an artist's albums. It gives no ISRC and no composer, and only the Apple links - the others are Odesli's.

const BASE_URI = 'https://itunes.apple.com/'

ItunesCatalog::__construct()

public function __construct(readonly HttpClientInterface $http, readonly string $country = 'us', readonly string $baseUri = self::BASE_URI)

ItunesCatalog::getName()

public function getName(): string

ItunesCatalog::links()

public function links(Reference $reference): PlatformLinks

ItunesCatalog::release()

public function release(Reference $reference): ?Release

ItunesCatalog::releases()

public function releases(string $artist, int $limit = 50, ?string $country = null): array

ItunesCatalogFactory class

final class ItunesCatalogFactory extends CatalogFactory ItunesCatalogFactory.php:18

The iTunes Search API: an artist's albums, their tracks with the 30-second previews, the artwork - no key.

options: country: 'de' # the store asked (ISO 3166-1 alpha-2, default us): what is sold there, in its language base_uri: 'https://itunes.apple.com/'

Options