Java client library for the Guardian APIs. See documentation here. All available API modules are supported - Content, Tags, Sections, Editions, and Single Item.
It is installable with any of the jvm package managers such as Gradle, Maven, sbt e.t.c.
Example gradle command:
implementation 'io.github.niyiomotoso:the-guardian-api-java-client:1.1.0'Sign up for an API key here
The primary Client\GuardianApi class is a factory class that creates objects for each of the API modules, allowing you to make requests to any of them with your desired request parameters. You have to first create an object for it, then access your desired API module via the object. See the code snippets below:
GuardianApi guardianApi = this.guardianApi = new GuardianApi(THE_GUARDIAN_API_KEY);For Content:
ContentResponse response = this.guardianApi.content().setQuery("12 years a slave").setTag("film/film,tone/reviews").setFromDate("2023-03-20").setShowTags("contributor").setShowFields("starRating,headline,thumbnail,short-url").setOrderBy("relevance").fetch();For Tags:
TagsResponse response = this.guardianApi.tags().setQuery("apple").setSection("technology").setShowReferences("all").fetch();For Sections:
SectonsResponse response = tthis.guardianApi.sections().setQuery("business").fetch();For Editions:
EditionsResponse response = this.guardianApi.editions().setQuery("uk").fetch();For Single Item:
SingleItemResponse response = this.guardianApi.singleItem().setId("/sport/2022/oct/07/cricket-jos-buttler-primed-for-england-comeback-while-phil-salt-stays-focused").setShowStoryPackage(true).setShowEditorsPicks(true).setShowMostViewed(true).setShowRelated(true).fetch();You can reach out to us on the Google Group here https://groups.google.com/g/guardian-api-talk for support