https://github.com/kwabenberko/news-api-java
An wrapper for newsapi.org
https://github.com/kwabenberko/news-api-java
android android-library java java-library newsapi newsapi-android-library newsapi-java-library newsapi-python retrofit2 wrapper wrapper-api wrapper-library
Last synced: 9 months ago
JSON representation
An wrapper for newsapi.org
- Host: GitHub
- URL: https://github.com/kwabenberko/news-api-java
- Owner: KwabenBerko
- License: mit
- Created: 2018-05-19T23:33:32.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-01-27T09:48:27.000Z (11 months ago)
- Last Synced: 2025-03-27T08:11:38.203Z (9 months ago)
- Topics: android, android-library, java, java-library, newsapi, newsapi-android-library, newsapi-java-library, newsapi-python, retrofit2, wrapper, wrapper-api, wrapper-library
- Language: Java
- Homepage:
- Size: 147 KB
- Stars: 31
- Watchers: 1
- Forks: 13
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: newsapilib/.gitignore
- License: LICENSE
Awesome Lists containing this project
README
## News-API-Java
**Create an account at [newsapi.org](https://newsapi.org/) to get your API key.**
## Download
### Using Gradle
#### Step 1. Add the JitPack repository to your root ```build.gradle``` file.
``` java
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
```
#### Step 2 : Download via ```Gradle```:
```java
implementation 'com.github.KwabenBerko:News-API-Java:1.0.2'
```
### Using Maven
#### Step 1. Add the JitPack repository to your ```pom.xml``` file.
``` java
jitpack.io
https://jitpack.io
```
#### Step 2 : Add the dependency to the dependencies in your ```pom.xml``` file:
```java
...
...
com.github.KwabenBerko
News-API-Java
1.0.2
```
## Usage
#### Instantiate the NewsApiClient class:
``` java
NewsApiClient newsApiClient = new NewsApiClient("YOUR_API_KEY");
```
#### Get Top Headlines
```java
newsApiClient.getTopHeadlines(
new TopHeadlinesRequest.Builder()
.q("bitcoin")
.language("en")
.build(),
new NewsApiClient.ArticlesResponseCallback() {
@Override
public void onSuccess(ArticleResponse response) {
System.out.println(response.getArticles().get(0).getTitle());
}
@Override
public void onFailure(Throwable throwable) {
System.out.println(throwable.getMessage());
}
}
);
```
#### Get Everything
```java
newsApiClient.getEverything(
new EverythingRequest.Builder()
.q("trump")
.build(),
new NewsApiClient.ArticlesResponseCallback() {
@Override
public void onSuccess(ArticleResponse response) {
System.out.println(response.getArticles().get(0).getTitle());
}
@Override
public void onFailure(Throwable throwable) {
System.out.println(throwable.getMessage());
}
}
);
```
#### Get Sources
```java
newsApiClient.getSources(
new SourcesRequest.Builder()
.language("en")
.country("us")
.build(),
new NewsApiClient.SourcesCallback() {
@Override
public void onSuccess(SourcesResponse response) {
System.out.println(response.getSources().get(0).getName());
}
@Override
public void onFailure(Throwable throwable) {
System.out.println(throwable.getMessage());
}
}
);
```