ballerinax/newsapi Ballerina library

Overview

The News API v2.0.0 connector(https://newsapi.org/docs) OpenAPI specification.

News API used to fetch news(articles, headlines and sources) from news sources and blogs across the web.

Key Features

• Programmatic access to create and manage resources via REST API
• Manage user accounts and profiles
• Secure authentication with API key or OAuth support

Prerequisites

Before using this connector in your Ballerina application, complete the following:

• Create News API Account
• Obtaining tokens
  1. Log into News API Account
  2. Get API key by clicking to Get API Key

Quickstart

Step 1: Import connector

Import the ballerinax/newsapi module into the Ballerina project.

import ballerinax/newsapi;

Step 2: Create a new connector instance

newsapi:ApiKeysConfig config = {
    apiKey : "<your apiKey>"
};

newsapi:Client myclient = check new newsapi:Client(config, {}, "https://newsapi.org/v2");

Step 3: Invoke connector operation

1. You can get top headlines as follows with listTopHeadlines method by passing country as a parameter.

   newsapi:WSNewsTopHeadlineResponse result = check myclient->listTopHeadlines(country="us");

2. Use bal run command to compile and run the Ballerina program.