iTunes

iTunes Search is Apple's media search service covering music, podcasts, audiobooks, movies, TV shows, and apps, accessible without an API key and one of the simplest media catalog lookups available.

MoEngage <> iTunes Search

The MoEngage <> iTunes Search integration allows you to personalise media campaigns with live catalog data from Apple at send time. Because no API key is required, it is the fastest media API to get running. Common use cases include surfacing an artist's latest release, showing a podcast's most recent episode, or recommending an app to a user based on their interests.

Integration

library_add_check

Prerequisites

No API key or account is required. The iTunes Search API is freely accessible to all.

Step 1: Identify your search parameters

No credentials to obtain. Simply identify the artist, term, or entity you want to search, and the media type you want returned. Refer to the iTunes Search API documentation for the full parameter reference.

Step 2: Set up the Content API on MoEngage

Navigate to Dashboard > Settings > APIs and open the Content API tab.
Click Add Content API.
Fill in the details using the table below as a reference.

Key Value

Name Choose a descriptive name, for example iTunes Artist Lookup.

Method GET

API URL

https://itunes.apple.com/search

Use https://itunes.apple.com/lookup to fetch a specific item by Apple ID. Refer to the iTunes Search API documentation.

Key Value Parameters

Parameter	Example value	Notes
`term`	`@user.favourite_artist`	Search term. Bind to a user attribute for personalised results.
`media`	`music`	Media type: `music`, `podcast`, `audiobook`, `movie`, `tvShow`, `software`.
`entity`	`album`	Entity to return: `album`, `song`, `musicArtist`, etc.
`limit`	`3`	Number of results to return.
`country`	`@user.country`	Two-letter ISO country code to localise the catalog.

Click Validate to confirm the platform returns a response, then click Save.

Once saved, refer to the MoEngage documentation on using Content APIs in campaigns to learn how to reference response fields inside your campaign templates.

Understanding the API response

The response contains a results array. Each object represents one media item.

Response field	Template variable example	Description
`results[0].collectionName`	`{{ContentApi.results[0].collectionName}}`	Album or collection name.
`results[0].artistName`	`{{ContentApi.results[0].artistName}}`	Artist name.
`results[0].artworkUrl100`	`{{ContentApi.results[0].artworkUrl100}}`	100x100 artwork image URL.
`results[0].releaseDate`	`{{ContentApi.results[0].releaseDate}}`	Release date in ISO 8601 format.
`results[0].collectionViewUrl`	`{{ContentApi.results[0].collectionViewUrl}}`	iTunes Store link — use as a CTA.
`results[0].primaryGenreName`	`{{ContentApi.results[0].primaryGenreName}}`	Primary genre name.