{"id":20222534,"url":"https://github.com/alfianlosari/itunesfeedgenerator","last_synced_at":"2026-03-15T23:31:44.128Z","repository":{"id":41382709,"uuid":"504785704","full_name":"alfianlosari/ITunesFeedGenerator","owner":"alfianlosari","description":"Provide Swiftly API to fetch top music, apps, books from iTunes Store","archived":false,"fork":false,"pushed_at":"2022-06-22T12:20:47.000Z","size":8,"stargazers_count":9,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-18T14:24:01.632Z","etag":null,"topics":["itunes","itunes-api","itunes-search","itunes-store","swift"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alfianlosari.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-06-18T08:21:16.000Z","updated_at":"2022-09-08T16:04:05.000Z","dependencies_parsed_at":"2022-09-12T04:10:36.073Z","dependency_job_id":null,"html_url":"https://github.com/alfianlosari/ITunesFeedGenerator","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/alfianlosari/ITunesFeedGenerator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alfianlosari%2FITunesFeedGenerator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alfianlosari%2FITunesFeedGenerator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alfianlosari%2FITunesFeedGenerator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alfianlosari%2FITunesFeedGenerator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alfianlosari","download_url":"https://codeload.github.com/alfianlosari/ITunesFeedGenerator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alfianlosari%2FITunesFeedGenerator/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265926967,"owners_count":23850886,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["itunes","itunes-api","itunes-search","itunes-store","swift"],"created_at":"2024-11-14T06:56:54.269Z","updated_at":"2026-03-15T23:31:44.066Z","avatar_url":"https://github.com/alfianlosari.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ITunesFeedGenerator\n\nThis library provides very simple and Swiftly way to fetch feeds from iTunes Store:\n- Most Played Songs.\n- Top Free or Paid Books. \n- Top Free or Paid Apps.\n- Most Played Albums/Music Videos/Playlists (Coming Soon).\n- Top Podcasts/Podcast Episodes (Coming Soon).\n- Top Audio Books (Coming Soon).\n\n## Features\n- Pass region code as parameter.\n- Pass result limit (10, 25, 50) as parameter.\n- Pass `top free` or `top paid` enum for books or apps feed\n- Swift Async Await Interface\n\n## Installation\n\nA detailed guide for installation can be found in Installation Guide.\n\n### Swift Package Manager\n\n- File \u003e Swift Packages \u003e Add Package Dependency\n- Add https://github.com/alfianlosari/ITunesFeedGenerator.git\n- Select \"Main\" branch\n\n## Example\n\n### Initialize repository\n\nFirst of all, you need to initalize the `FeedRepository`.\n\n```swift\nlet repository = FeedRepository()\n```\n\n### Fetch most played songs\n\n```swift\n// Fetch top 50 most played songs in Indonesia\nlet songs = try await repository.getMostPlayedSongsFeed(region: \"id\", resultLimit: .limit50)\n```\n\n### Fetch top free or top paid apps\n\n```swift\n// Fetch top 10 free apps in Great Britain\nlet topPaidApps = try await repository.getTopAppsFeed(region: \"gb\", type: .topFree, resultLimit: .limit10)\n\n// Fetch top 25 paid apps in Singapore\nlet topPaidApps = try await repository.getTopAppsFeed(region: \"sg\", type: .topPaid, resultLimit: .limit25)\n```\n\n### Fetch top free or top paid books\n\n```swift\n// Fetch top 10 free books in Great Britain\nlet topPaidApps = try await repository.getTopBooksFeed(region: \"gb\", type: .topFree, resultLimit: .limit10)\n\n// Fetch top 25 paid books in United States\nlet topPaidApps = try await repository.getTopBooksFeed(region: \"us\", type: .topPaid, resultLimit: .limit25)\n```\n\n### Supported Region Code Strings\n\nYou can get the list of all supported region code parameters from this [GitHub Gist](https://gist.github.com/daFish/5990634). Kudos to [Marcus Stöhr/daFish](https://gist.github.com/daFish)\n\n### SwiftUI Helper Library\n\nI also created a library that provide SwiftUI Views to display song/book/app and ObservableObjects to fetch the data using phase state mechanism (loading, success, failure). You can check it out at [ITunesFeedSwiftUI](https://github.com/alfianlosari/ITunesFeedSwiftUI)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falfianlosari%2Fitunesfeedgenerator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falfianlosari%2Fitunesfeedgenerator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falfianlosari%2Fitunesfeedgenerator/lists"}