kirill-latish/laravel-newsapi

Laravel wrapper for https://newsapi.org/

Laravel Package for NewsAPI.org

Laravel wrapper for NewsAPI.org API calls. Documentation for the API can be found here, _(*1)

Installation

1- Require the package via Composer in your composer.json., _(*2)

{
  "require": {
    "kirill-latish/laravel-newsapi": "^1.0"
  }
}

2- Run Composer to install or update the new requirement., _(*3)

$ composer install

or, _(*4)

$ composer update

3- Add the service provider to your app/config/app.php file, _(*5)

NewsAPI\NewsAPIServiceProvider::class,

4- Add the facade to your app/config/app.php file, _(*6)

'NewsAPI' => NewsAPI\Facades\NewsAPI::class,

5- Publish the configuration file, _(*7)

$ php artisan vendor:publish --provider="NewsAPI\NewsAPIServiceProvider"

6- Review the configuration file and add your key (preferably through env: 'api_key' => env('NEWSAPI_KEY') ), _(*8)

config/newsapi.php

Usage

Refer to the official docs as to which calls can be made and check the calls in traits under NewsAPI\Requests., _(*9)

For example, get all sources (if using facade):, _(*10)

use NewsAPI;

...

$response = NewsAPI::sources()->all();

The above returns an object containing a sources array., _(*11)

Get a top headlines by country and category:, _(*12)

$response = NewsAPI::topHeadlines()->get([
            'country' => 'gb',
            'category'=>'sports'
        ]);

Get all news from bbc.co.uk in English for time period from 2018-05-01 to 2018-05-04 sorted by publication date:, _(*13)

        $response = NewsAPI::everything()->get([
            'language' => 'en',
            'domains'=>'bbc.co.uk',
            'from' => '2018-05-01',
            'to' => ''2018-05-04,
            'sortBy' => 'publishedAt',
        ]);