{"repo":"fvdm/nodejs-searchitunes","free":true,"listed":false,"github":"https://github.com/fvdm/nodejs-searchitunes","clone":"git clone https://github.com/fvdm/nodejs-searchitunes.git","description":"Lightweight node.js module to quickly search Apple's iTunes Store for music, movies, apps, etc.","language":"JavaScript","stars":29,"topics":["music","apple-itunes-store","appstore","api-client","nodejs","movies","apps","unlicense"],"license":"Unlicense","category":"media-processing","readme_excerpt":"searchitunes Lightweight Node.js package to quickly search the Apple iTunes Store and App Store for music, movies, apps, etc. Example Installation npm i searchitunes Interface The module exports only one function. Arguments must be wrapped in an object. It returns a Promise. Configuration The parameters below can be included along with the normal API params. param type default description :------------ :------- :---------------- :----------- [timeout] number 5000 Wait time out in ms [userAgent] string searchitunes.js User-Agent header [throwEmpty] bool true Throw no results instead of returning [] ... mixed API parameters Search API For searching in the iTunes databases you simply include the search params in your request. The function will resolve with an object. - Search API docs - Live demo Lookup by ID When you wish to retrieve one specific item by its ID, include one of the ID params to use the Lookup API. The result data will be only the object with the item's details. - Lookup API docs ID params - amgAlbumId - amgArtistId - amgVideoId - id - isbn - upc - trackId When you lookup a trackId from a search response it will be automatically converted to the id parameter instead. Otherwise the API won't understand it. Bulk lookup To request multiple objects at once you set one of the ID params above to an array with the item ID's. This will always return an array . Errors API errors are handled and thrown, prefixed with API: When nothing is found it will throw with no results","default_branch":null,"files":null,"tree":[],"storefront":"/r/fvdm","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/fvdm/nodejs-searchitunes/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}