Itunes Search Search
itunes_search_searchSearch the Apple iTunes catalog by keyword across music, movies, podcasts, TV shows, apps, ebooks, and more; filterable by media type, entity, country, and explicit flag; returns up to 200 matching items with metadata.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"term": "Taylor Swift"
},
"name": "itunes_search_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | en_us | ja_jp (default en_us) | |
| term | Yes | Search query | |
| limit | No | 1-200 (default 50) | |
| media | No | music | movie | podcast | musicVideo | audiobook | shortFilm | tvShow | software | ebook | all (default all) | |
| entity | No | Refines media, e.g. "song", "album", "movieArtist", "tvSeason" | |
| country | No | ISO 3166-1 alpha-2 (default us) | |
| explicit | No | Yes (default) | No, exclude explicit content | |
| attribute | No | Restrict matching field, e.g. "artistTerm", "albumTerm", "movieTerm" |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| results | Yes | Array of search result items | |
| resultCount | Yes | Number of results returned |