{"openapi":"3.1.0","info":{"title":"App Store API","version":"1.0.0","description":"Search and look up apps on the Apple App Store as an API. Pass a search term and get matching iOS apps with their developer, average star rating and rating count, price, category and icon; or look up a single app by its App Store id (or bundle id) for the full record — description, current version, release and update dates, content rating, minimum iOS version, app size, supported languages, screenshots and the store link. Ratings and price are returned per country (default US). Live from the public iTunes Search API. Ideal for app-store optimisation (ASO), competitor and market research, app directories, review dashboards and mobile-developer tools. Public Apple data.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/appstore-api","description":"oanor gateway"}],"tags":[{"name":"App Store"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/app":{"get":{"operationId":"get_v1_app","tags":["App Store"],"summary":"One app by id or bundle id","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"App Store numeric id, e.g. 324684580 (Spotify)","schema":{"type":"string"},"example":"324684580"},{"name":"bundle_id","in":"query","required":false,"description":"Bundle id (alternative to id), e.g. com.spotify.client","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"2-letter country (default US)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"app":{"id":324684580,"url":"https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580?uo=4","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/26/53/7b/26537b47-88c8-845a-fb1b-a65702602a10/AppIcon-0-0-1x_U007epad-0-1-0-0-sRGB-85-220.png/512x512bb.jpg","name":"Spotify: Music and Podcasts","genre":"Music","price":"Free","genres":["Music","Entertainment"],"rating":4.78,"size_mb":258.8,"updated":"2026-05-15T08:29:09Z","version":"9.1.48","currency":"USD","released":"2011-07-14T11:22:37Z","bundle_id":"com.spotify.client","developer":"Spotify","languages":["AF","AM","AR","AZ","EU","BN","BS","BG","CA","HR","CS","DA","NL","EN","ET","FI","FR","GL","DE","EL","GU","HE","HI","HU","IS","ID","IT","JA","KN","KO","LV","LT","MK","MS","ML","MR","NE","NB","OR","FA","PL","PT","PA","RO","RU","SR","ZH","SK","SL","ES","SW","SV","TA","TE","TH","ZH","TR","UK","UR","VI","ZU"],"description":"With the Spotify app, you can explore an extensive library of music and podcasts for free. Curate the best playlists and stream millions of free songs, albums, and original podcasts on your phone or tablet. Subscribe to Spotify Premium to download and listen offline wherever you are, and unlock our catalog of audiobooks.\n\nWhy choose Spotify as your go-to music and podcast app? Here, you can:\n• Listen to over 100 million songs and 6 million podcast titles\n• Explore our selection of specially-crafted artist playlists\n• Easily search for your favorite songs, albums, artists, and podcasts\n• Discover personalized music recommendations tailored to your unique taste\n• Subscribe to your favorite free podcasts so you never miss an episode, and even curate your own podcast library\n\nSpotify Free is more than a music player - find the sounds you love and stream music and podcasts online, for free. Enjoy personalized playlists or curate and share your own, discover the hottest new releases, explore upcoming events from your favorites, and more.\n\n• Stream millions of free songs and podcasts\n• Create playlists with your favorite music\n• Share songs and playlists with friends and family (feature restrictions may apply in some regions)\n• Discover personalized playlists made just for you, and collaborate on playlists with your friends\n• Enjoy your personal Discover Weekly playlist every week\n• Stay in the know with the Release Radar and New Music Friday playlists\n• Find nearby events and gigs by your favorite artists\n• See your most played songs, genres, artists, and more with yearly Spotify Wrapped\n• Stream music across your devices with Spotify\n• Use Spotify Connect and enjoy listening on smart speakers, desktop, laptop, smart TV, Chromecast, PlayStation®, Xbox®, smartwatch, in your car, and more - limited number of device models apply\n\nSpotify Premium - a great way to enjoy the benefits of an offline music player, and stream music without WiFi. By pressing download, you can access your songs, playlists, podcasts, and audiobooks offline, wherever you are.\n• Listen to music, podcasts, and audiobooks - all in one place\n• Ad-free music listening: enjoy your music with no ad interruptions\n• Enjoy full on-demand playback\n• Audiobooks in Premium are currently available in the US, UK, Australia, Ireland, New Zealand, and Canada. Discover 250,000+ audiobook titles with 15 hours/month of available listening for Premium Individual subscribers and Duo & Family plan managers.\n• Superior sound quality on supported devices\n• AI DJ: a personalized guide that knows your music taste so well it can choose what to play for you\n• Enjoy on desktop, phone, tablet, computer, smartwatch, and in your car\n• Listen and control the listening session together by hosting a Jam in real time with friends\n• Download songs, podcasts, and audiobooks for offline listening, without an internet connection\n• No contract required - cancel your subscription whenever you want\n\nSpotify lets you play music wherever you are. Listen to your favorite songs and discover new music, podcasts, and audiobooks with the Spotify app!\n\nLOVE SPOTIFY?\nFollow us on Instagram: https://www.instagram.com/spotify\nFollow us on TikTok: https://www.tiktok.com/@spotify","price_value":0,"screenshots":["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/f3/ce/05/f3ce0547-690a-b355-b1dd-6b6e91808279/IOS_-_5.5_-_S01_-_EN_-_CA_U005bEnglish__U0028Canada_U0029_U005d.png/392x696bb.png","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/78/81/ca/7881ca10-b441-1a6c-e030-92e08dd76144/IOS_-_5.5_-_S02_-_EN_-_CA_U005bEnglish__U0028Canada_U0029_U005d.png/392x696bb.png","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/5b/e7/6a/5be76ae0-8bc6-59fc-58ef-92aa931b6dba/IOS_-_5.5_-_S03_-_EN_-_CA_U005bEnglish__U0028Canada_U0029_U005d.png/392x696bb.png","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/cf/ef/84/cfef8425-3610-a4b5-b4d8-1f22da2449d8/IOS_-_5.5_-_S04_-_EN_-_CA_U005bEnglish__U0028Canada_U0029_U005d.png/392x696bb.png","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/52/66/2a/52662aa9-7a10-a349-f1cb-787143401ace/IOS_-_5.5_-_S05_-_EN_-_CA_U005bEnglish__U0028Canada_U0029_U005d.png/392x696bb.png","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/91/12/40/9112404c-d50d-bae4-1d42-4a0153ab7cfc/IOS_-_5.5_-_S06_-_EN_-_CA_U005bEnglish__U0028Canada_U0029_U005d.png/392x696bb.png","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/b9/df/e9/b9dfe9f4-7716-a072-6d8b-d683ed92c75f/IOS_-_5.5_-_S07_-_EN_-_CA_U005bEnglish__U0028Canada_U0029_U005d.png/392x696bb.png","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/cb/55/ca/cb55ca54-a183-ea42-3a46-9c2fa59ea289/IOS_-_5.5_-_S08_-_EN_-_CA_U005bEnglish__U0028Canada_U0029_U005d.png/392x696bb.png"],"developer_id":324684583,"rating_count":40129084,"release_notes":"We’re always making changes and improvements to Spotify. To make sure you don’t miss a thing, just keep your Updates turned on.","content_rating":"12+","ipad_screenshots":["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/31/15/15/31151525-510a-a212-ea51-e023e7b6351f/IOS_-_Ipad_6th_-_S01_-_EN_-_CA_U005bEnglish__U0028Canada_U0029_U005d.png/552x414bb.png","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/6a/bc/17/6abc17c9-7291-a6e8-0383-7d59764f977f/IOS_-_Ipad_6th_-_S02_-_EN_-_CA_U005bEnglish__U0028Canada_U0029_U005d.png/552x414bb.png","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/34/13/3e/34133e65-eec7-d68d-f81c-1a57b78ba122/IOS_-_Ipad_12.9__-_S03_-_EN_-_CA_U005bEnglish__U0028Canada_U0029_U005d.png/552x414bb.png","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/d2/3b/d7/d23bd702-b7d9-e2ab-10ae-e4de6a4ddff2/IOS_-_Ipad_12.9__-_S04_-_EN_-_CA_U005bEnglish__U0028Canada_U0029_U005d.png/552x414bb.png","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/53/f7/f8/53f7f885-da91-92b6-31f5-ef633a240c3b/IOS_-_Ipad_12.9__-_S05_-_EN_-_CA_U005bEnglish__U0028Canada_U0029_U005d.png/552x414bb.png","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/da/77/de/da77deee-7747-12df-be82-adabf672c373/IOS_-_Ipad_12.9__-_S06_-_EN_-_CA_U005bEnglish__U0028Canada_U0029_U005d.png/552x414bb.png"],"minimum_os_version":"16.1","supported_devices_count":128}},"meta":{"timestamp":"2026-05-31T11:29:28.118Z","request_id":"29536175-59db-4c99-a43d-f3860abb2ffd"},"status":"ok","message":"App retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["App Store"],"summary":"Search the App Store","description":"","parameters":[{"name":"term","in":"query","required":true,"description":"Search term, e.g. spotify","schema":{"type":"string"},"example":"spotify"},{"name":"country","in":"query","required":false,"description":"2-letter country, e.g. US, GB, DE (default US)","schema":{"type":"string"}},{"name":"genre","in":"query","required":false,"description":"Genre id to filter by","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results (1-100, default 20)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"term":"spotify","count":15,"country":"US","results":[{"id":324684580,"url":"https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580?uo=4","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/26/53/7b/26537b47-88c8-845a-fb1b-a65702602a10/AppIcon-0-0-1x_U007epad-0-1-0-0-sRGB-85-220.png/512x512bb.jpg","name":"Spotify: Music and Podcasts","genre":"Music","price":"Free","genres":["Music","Entertainment"],"rating":4.78,"size_mb":258.8,"version":"9.1.48","currency":"USD","bundle_id":"com.spotify.client","developer":"Spotify","price_value":0,"developer_id":324684583,"rating_count":40129084,"content_rating":"12+"},{"id":1108187390,"url":"https://apps.apple.com/us/app/apple-music/id1108187390?uo=4","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/31/6c/c3/316cc33a-5e7d-8902-58eb-f4e16c5d9440/music-0-0-1x_U007epad-0-1-0-sRGB-85-220.png/512x512bb.jpg","name":"Apple Music","genre":"Music","price":"Free","genres":["Music"],"rating":4.86,"size_mb":5.9,"version":"2.9","currency":"USD","bundle_id":"com.apple.Music","developer":"Apple Inc.","price_value":0,"developer_id":284417353,"rating_count":2786207,"content_rating":"12+"},{"id":1017492454,"url":"https://apps.apple.com/us/app/youtube-music/id1017492454?uo=4","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/98/78/c6/9878c6f0-051a-f585-f8bd-2e0637323969/logo_youtube_music_2024_q4_color-0-0-1x_U007emarketing-0-0-0-7-0-0-0-85-220.png/512x512bb.jpg","name":"YouTube Music","genre":"Music","price":"Free","genres":["Music","Entertainment"],"rating":4.77,"size_mb":261.6,"version":"9.21","currency":"USD","bundle_id":"com.google.ios.youtubemusic","developer":"Google LLC","price_value":0,"developer_id":281956209,"rating_count":1513623,"content_rating":"12+"},{"id":336353151,"url":"https://apps.apple.com/us/app/soundcloud-the-music-you-love/id336353151?uo=4","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/f5/55/51/f555511a-13c3-1497-c322-aff959b9a116/AppIcon-0-0-1x_U007epad-0-1-0-85-220.png/512x512bb.jpg","name":"SoundCloud: The Music You Love","genre":"Music","price":"Free","genres":["Music","Social Networking"],"rating":4.84,"size_mb":250.4,"version":"8.62.1","currency":"USD","bundle_id":"com.soundcloud.TouchApp","developer":"SoundCloud Global Limited & Co KG","price_value":0,"developer_id":1543929086,"rating_count":1859104,"content_rating":"12+"},{"id":544007664,"url":"https://apps.apple.com/us/app/youtube/id544007664?uo=4","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/32/eb/ea/32ebea9d-8f35-c18a-504e-28d6afcd3eb5/logo_youtube_2024_q4_color-0-0-1x_U007emarketing-0-0-0-7-0-0-0-85-220.png/512x512bb.jpg","name":"YouTube","genre":"Photo & Video","price":"Free","genres":["Photo & Video","Entertainment"],"rating":4.67,"size_mb":348,"version":"21.22.04","currency":"USD","bundle_id":"com.google.ios.youtube","developer":"Google LLC","price_value":0,"developer_id":281956209,"rating_count":47425554,"content_rating":"12+"},{"id":1526912392,"url":"https://apps.apple.com/us/app/stats-fm-for-spotify-music-app/id1526912392?uo=4","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/07/14/81/07148123-8c5e-c505-f165-8c745cb82881/AppIcon-0-0-1x_U007emarketing-0-8-0-85-220.png/512x512bb.jpg","name":"stats.fm for Spotify Music App","genre":"Music","price":"Free","genres":["Music","Utilities"],"rating":4.62,"size_mb":234.3,"version":"2.3.2","currency":"USD","bundle_id":"dev.netlob.spotistats","developer":"StatsFM B.V.","price_value":0,"developer_id":1628068538,"rating_count":45699,"content_rating":"9+"},{"id":284993459,"url":"https://apps.apple.com/us/app/shazam-find-music-concerts/id284993459?uo=4","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/99/f5/04/99f504c7-feb7-34c0-9edc-e9bd5a330a5b/AppIcon-0-0-1x_U007epad-0-1-sRGB-85-220.png/512x512bb.jpg","name":"Shazam: Find Music & Concerts","genre":"Music","price":"Free","genres":["Music","Entertainment"],"rating":4.9,"size_mb":69.5,"version":"26.10","currency":"USD","bundle_id":"com.shazam.Shazam","developer":"Apple Inc.","price_value":0,"developer_id":284417353,"rating_count":8689109,"content_rating":"12+"},{"id":1222021797,"url":"https://apps.apple.com/us/app/spotify-for-artists/id1222021797?uo=4","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/f2/92/2a/f2922a57-1f6d-a2d7-9a96-598aa7e83a7a/AppIcon-0-0-1x_U007ephone-0-1-0-0-sRGB-85-220.png/512x512bb.jpg","name":"Spotify for Artists","genre":"Music","price":"Free","genres":["Music","Business"],"rating":2.91,"size_mb":50.3,"version":"2.2.28","currency":"USD","bundle_id":"com.spotify.s4a","developer":"Spotify","price_value":0,"developer_id":324684583,"rating_count":1736,"content_rating":"12+"},{"id":921765888,"url":"https://apps.apple.com/us/app/audiomack-play-music-offline/id921765888?uo=4","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/39/1a/3c/391a3cad-ac8a-ee2e-e8a4-108c82e44df2/AppIcon-1-0-0-1x_U007emarketing-0-6-0-85-220.png/512x512bb.jpg","name":"Audiomack - Play Music Offline","genre":"Music","price":"Free","genres":["Music","Entertainment"],"rating":4.8,"size_mb":350.9,"version":"8.5.1","currency":"USD","bundle_id":"com.audiomack.iphone","developer":"Audiomack, Inc.","price_value":0,"developer_id":921765887,"rating_count":1967648,"content_rating":"12+"},{"id":1259949354,"url":"https://apps.apple.com/us/app/offline-music-player/id1259949354?uo=4","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/5d/62/e3/5d62e34f-c473-a1e1-99d4-9133d525a351/AppIcon-0-0-1x_U007emarketing-0-8-0-85-220.png/512x512bb.jpg","name":"Offline Music Player","genre":"Music","price":"Free","genres":["Music","Entertainment"],"rating":4.57,"size_mb":176.2,"version":"3.8.4","currency":"USD","bundle_id":"com.offlinemusic","developer":"Md Zakir Hossain","price_value":0,"developer_id":1434223233,"rating_count":54418,"content_rating":"4+"},{"id":6444621447,"url":"https://apps.apple.com/us/app/must-fm-for-spotify-stats/id6444621447?uo=4","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/4d/da/8e/4dda8e72-c643-788f-c058-e82a82555369/AppIcon-0-0-1x_U007ephone-0-1-0-85-220.jpeg/512x512bb.jpg","name":"must.fm for Spotify Stats","genre":"Music","price":"Free","genres":["Music","Utilities"],"rating":4.58,"size_mb":502.3,"version":"14.7.2","currency":"USD","bundle_id":"com.spotistats.music.app","developer":"VICTORY LABS S.L.","price_value":0,"developer_id":1800421368,"rating_count":9277,"content_rating":"17+"},{"id":1056182234,"url":"https://apps.apple.com/us/app/spotify-for-creators/id1056182234?uo=4","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/48/00/2a/48002ae1-b795-e3b1-106a-da5eafb56de7/AppIcon-0-0-1x_U007epad-0-1-0-85-220.png/512x512bb.jpg","name":"Spotify for Creators","genre":"News","price":"Free","genres":["News","Social Networking"],"rating":4.84,"size_mb":72.1,"version":"7.101.0","currency":"USD","bundle_id":"com.anchorfminc.Anchor","developer":"Spotify","price_value":0,"developer_id":324684583,"rating_count":117620,"content_rating":"12+"},{"id":1110273623,"url":"https://apps.apple.com/us/app/music-x-best-music-streaming/id1110273623?uo=4","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple112/v4/c4/96/31/c496315f-15e3-6cc9-b66e-0d781e197f3c/AppIcon-0-0-1x_U007emarketing-0-7-0-85-220.png/512x512bb.jpg","name":"Music X - Best music streaming","genre":"Music","price":"Free","genres":["Music","Entertainment"],"rating":3.98,"size_mb":7.9,"version":"3.8","currency":"USD","bundle_id":"com.hungvan.freemusic","developer":"Hung Van","price_value":0,"developer_id":1008312110,"rating_count":12988,"content_rating":"4+"},{"id":1662272925,"url":"https://apps.apple.com/us/app/music-player-songs-videos/id1662272925?uo=4","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/37/8e/5d/378e5d1b-7ae6-f49b-a1af-7cf5fa46390c/AppIcon-0-0-1x_U007emarketing-0-11-0-85-220.png/512x512bb.jpg","name":"Music Player : Songs, Videos","genre":"Utilities","price":"Free","genres":["Utilities"],"rating":4.55,"size_mb":35.2,"version":"3.2","currency":"USD","bundle_id":"com.blackmusic.wix","developer":"Petko kochev","price_value":0,"developer_id":1863776857,"rating_count":49426,"content_rating":"9+"},{"id":1660243228,"url":"https://apps.apple.com/us/app/music-player-songs-streaming/id1660243228?uo=4","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/5f/80/0e/5f800e63-663d-2abe-6b11-dbd6a8217308/AppIcon-0-0-1x_U007emarketing-0-11-0-85-220.png/512x512bb.jpg","name":"Music Player : Songs Streaming","genre":"Music","price":"Free","genres":["Music"],"rating":4.61,"size_mb":56.9,"version":"4.0","currency":"USD","bundle_id":"com.songu.yt.blackhole","developer":"Nabeel Faiz","price_value":0,"developer_id":1660243230,"rating_count":3809,"content_rating":"9+"}]},"meta":{"timestamp":"2026-05-31T11:29:28.228Z","request_id":"2a55797c-933f-44d0-be83-706560b137c9"},"status":"ok","message":"Apps searched","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Source & notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Search and look up iOS apps on the Apple App Store. /v1/search?term= returns matching apps with developer, rating, price, genre and icon; /v1/app?id= (or bundle_id=) returns one app's full details incl. description, screenshots, version history and supported languages. Ratings and price are country-specific (default country=US).","source":"Apple App Store (iTunes Search API)","endpoints":["/v1/search","/v1/app","/v1/meta"]},"meta":{"timestamp":"2026-05-31T11:29:28.298Z","request_id":"eafb4662-0574-4f8b-869d-416df1264eb7"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3780,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":470,"monthly_call_quota":50500,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1310,"monthly_call_quota":246000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3470,"monthly_call_quota":1209000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/appstore-api"}