{"id":19811534,"url":"https://github.com/beverlyroadgoose/itunessearch","last_synced_at":"2025-02-28T13:20:18.249Z","repository":{"id":57736749,"uuid":"107007373","full_name":"beverlyRoadGoose/ItunesSearch","owner":"beverlyRoadGoose","description":"A Java wrapper for the Itunes search API","archived":false,"fork":false,"pushed_at":"2023-05-09T17:56:01.000Z","size":1129,"stargazers_count":2,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-11T07:14:53.947Z","etag":null,"topics":["apple","itunes","itunes-api","itunes-podcast-feed","itunes-search","itunes-store","java-wrapper","side-project"],"latest_commit_sha":null,"homepage":"https://beverlyroadgoose.github.io/ItunesSearch/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/beverlyRoadGoose.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"license.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-10-15T11:46:33.000Z","updated_at":"2023-08-08T00:59:12.000Z","dependencies_parsed_at":"2024-11-12T09:38:25.725Z","dependency_job_id":null,"html_url":"https://github.com/beverlyRoadGoose/ItunesSearch","commit_stats":null,"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beverlyRoadGoose%2FItunesSearch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beverlyRoadGoose%2FItunesSearch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beverlyRoadGoose%2FItunesSearch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beverlyRoadGoose%2FItunesSearch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/beverlyRoadGoose","download_url":"https://codeload.github.com/beverlyRoadGoose/ItunesSearch/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241156669,"owners_count":19919341,"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":["apple","itunes","itunes-api","itunes-podcast-feed","itunes-search","itunes-store","java-wrapper","side-project"],"created_at":"2024-11-12T09:26:50.761Z","updated_at":"2025-02-28T13:20:18.223Z","avatar_url":"https://github.com/beverlyRoadGoose.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/beverlyRoadGoose/ItunesSearch.svg?branch=master\u0026maxAge=1)](https://travis-ci.org/beverlyRoadGoose/ItunesSearch)\n[![Coverage Status](https://coveralls.io/repos/github/beverlyRoadGoose/ItunesSearch/badge.svg?branch=master\u0026maxAge=1)](https://coveralls.io/github/beverlyRoadGoose/ItunesSearch?branch=master)\n[![Codacy Badge](https://api.codacy.com/project/badge/Grade/6139acc8bc4c44dd91d73fa2456ec52d)](https://www.codacy.com/app/beverlyRoadGoose/ItunesSearch?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=beverlyRoadGoose/ItunesSearch\u0026amp;utm_campaign=Badge_Grade)\n[![GitHub version](https://badge.fury.io/gh/beverlyRoadGoose%2FItunesSearch.svg)](https://github.com/beverlyRoadGoose/ItunesSearch/releases)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg?maxAge=1)](https://opensource.org/licenses/Apache-2.0)\n\n## About\nThis is a Java wrapper for the [iTunes Search API](https://affiliate.itunes.apple.com/resources/documentation/itunes-store-web-service-search-api/).\n\n## Usage\n**Adding the library to your project**\n\n**Gradle**\n```Gradle\ncompile group: 'me.tobiadeyinka', name: 'iTunesSearch', version: '1.5.3'\n```\n\n**Maven**\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003eme.tobiadeyinka\u003c/groupId\u003e\n    \u003cartifactId\u003eiTunesSearch\u003c/artifactId\u003e\n    \u003cversion\u003e1.5.3\u003c/version\u003e\n\u003c/dependency\u003e\n```\n      \n**Making calls to the API**\n\nUsing Podcast's search as an example, to search for \"Radiolab\" and leaving all other parameters set to default, it's as simple as:\n```java\nnew PodcastSearch()\n    .with(\"radiolab\")\n    .execute();\n```\n\nTo compare your search term with only a particular attribute, for example the genre of podcasts, you can specify that this way:\n```java\nnew PodcastSearch()\n    .with(\"radiolab\")\n    .inAttribute(PodcastAttribute.GENRE);\n    .execute();\n```\n\nTo run your search in only one itunes store, just pass the [ISO 3166-1 alpha-2 code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) \nfor that country, this example uses Nigeria:\n```java\nnew PodcastSearch()\n    .with(\"radiolab\")\n    .inCountry(CountryCode.NG)\n    .execute();\n```\n\nSearching other media types follow the same method. To search every media type in one call, use [MediaSearch](https://beverlyRoadGoose.github.io/ItunesSearch/docs/):\n```java\nnew MediaSearch()\n    .with(\"something\")\n    .execute();\n```\nThere are much more configurations available all of which are detailed in the [wiki](https://github.com/beverlyRoadGoose/ItunesSearch/wiki).\n\nTo lookup up lists or items from the store, use the lookup API's. For example, to get the top songs in the store:\n```java\nMusicLookup.topSongs();\n```\n\nTo get the top _n_ songs:\n```java\nMusicLookup.topSongs(n);\n```\n\nThe javadoc is also available [here](https://beverlyRoadGoose.github.io/ItunesSearch/docs/).\nAll searches and lookups return a [JSON object](https://stleary.github.io/JSON-java/).\n\n## Disclaimer\niTunes is a trademark of Apple Inc., registered in the U.S. and other countries.\n\nThis library has not been authorized, sponsored, or otherwise approved by Apple Inc.\n\n## License\n\n```\n   Copyright 2018 Oluwatobi Adeyinka\n\n   \n   Licensed under the Apache License, Version 2.0 (the \"License\");\n   you may not use this file except in compliance with the License.\n   You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n   Unless required by applicable law or agreed to in writing, software\n   distributed under the License is distributed on an \"AS IS\" BASIS,\n   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n   See the License for the specific language governing permissions and\n   limitations under the License.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeverlyroadgoose%2Fitunessearch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbeverlyroadgoose%2Fitunessearch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeverlyroadgoose%2Fitunessearch/lists"}