PHPackages                             shamithewebdeveloper/laravel-nytimes-api - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. shamithewebdeveloper/laravel-nytimes-api

ActiveLibrary[API Development](/categories/api)

shamithewebdeveloper/laravel-nytimes-api
========================================

A Laravel package for working with the New York Times API.

v1.0.2(8mo ago)02MITPHPPHP >=7.4

Since Aug 29Pushed 8mo agoCompare

[ Source](https://github.com/ShamiTheWebdeveloper/laravel-nytimes-api)[ Packagist](https://packagist.org/packages/shamithewebdeveloper/laravel-nytimes-api)[ RSS](/packages/shamithewebdeveloper-laravel-nytimes-api/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

Laravel NYTimes API Package
===========================

[](#laravel-nytimes-api-package)

A lightweight Laravel package to easily integrate the New York Times API into your Laravel applications. Fetch the latest news, articles, and top stories directly from NYTimes with simple and elegant syntax.

🚀 Features
----------

[](#-features)

- Simple integration with the New York Times API
- Supports Top Stories, Most Popular, and Article Search endpoints
- Built-in Facade (NYTimes) and helper methods
- Powered by GuzzleHTTP for secure API requests
- Compatible with Laravel 8, 9, 10, 11, and 12

📦 Installation
--------------

[](#-installation)

```
  composer require shamithewebdeveloper/laravel-nytimes-api
```

🔧 Configuration
---------------

[](#-configuration)

1. Publish the config file:

```
  php artisan vendor:publish --tag=nytimes-config
```

2. Add your NYTimes API Key(Public Key) in .env:

`NYTIMES_API_KEY=your_api_key_here`

3. Add this to the service provider:

```
ShamiTheWebdeveloper\NYTimes\NYTimesServiceProvider::class
```

4. If you want to use the NYTimes directly in view files (Optional):

Add this to app/config.php (For Laravel 8,9, and 10)

```
'aliases' => [
        'NYTimes' => \ShamiTheWebdeveloper\NYTimes\Facades\NYTimesFacade::class,
    ]
```

For Laravel 11 or greater, add this to app/Providers/AppServiceProvider.php in register() function

```
use ShamiTheWebdeveloper\NYTimes\Facades\NYTimesFacade;
public function register(): void
    {
        $loader = AliasLoader::getInstance();
        $loader->alias('NYTimes', NYTimesFacade::class);
    }
```

📝 Usage
-------

[](#-usage)

Retrive Data From API

```
use ShamiTheWebdeveloper\NYTimes\NYTimes;

NYTimes::searchArticle('Sports', now()->lastWeekDay, now())->get();
// use get() to get response in array

NYTimes::searchArticle('Sports', now()->lastWeekDay, now())->json();
// use json() to get response in json
```

Get a full response from GuzzleHttp

```
$articlesFullResponse=NYTimes::searchArticle('Sports', '2024-04-01', now())->fullResponse();
dd($articlesFullResponse);
```

Get API Request URL

```
$articleURL=NYTimes::searchArticle('Sports', '2024-04-01', now())->requestURL();
echo $articleURL;
```

For the views

```
@dd(NYTimes::newsSectionList()->get())
```

### Examples

[](#examples)

For Article Search:

```
/*
Parameters
$query (string required), $start_date (string), $end_date (string), $filter_query (string), $sort (string), $page=1 (int)
*/

$articles=NYTimes::searchArticle('Sports', now()->lastWeekDay, now())->get();

foreach ($articles['response']['docs'] as $article)
{
  echo $article['abstract'].'';
  echo $article['web_url'].'';
}
```

For Archive:

```
/*
Parameters
$month (int required), $year (int required)
*/

$archives= NYTimes::archive(5,2025)->get();

foreach ($archives['response']['docs'] as $archive) {
    echo $archive['abstract'].'';
    echo $archive['section_name'].'';
    echo $archive['word_count'].'';
}
```

For Most Popular:

```
/*
Parameters
$type (string required), $period (int), $shareType (string)
*/

$populars= NYTimes::mostPopular('emailed',7)->get();

foreach ($populars['results'] as $popular) {
    echo $popular['section'].'';
    echo $popular['title'].'';
    echo $popular['abstract'].'';
}
```

For Books (Overview)

```
/*
Parameters
$publishedDate (string)
*/

$books=NYTimes::bookOverview('2024-05-04')->get();

echo $books['results']['published_date'].'';
echo 'Books:';

foreach ($books['results']['lists'] as $booklist)
{
  echo $booklist['list_name'].'';

  foreach ($booklist['books'] as $book)
  {
    echo $book['title'].'';
    echo $book['author'].'';
  }
}
```

For Books (List)

```
/*
Parameters
$list (string required) ,$date (string)
*/

$books=NYTimes::bookList('series-books')->get();

echo ''.$books['results']['list_name'].'';

foreach ($books['results']['books'] as $book)
{
    echo $book['title'].'';
    echo $book['author'].'';
}
```

For Times Newswire

```
/*
Parameters
$source (string required) ,$section (string) ,$limit (int), $offset (int)
*/

$news=NYTimes::timesNewswire('nyt','all',30,20)->get();

foreach ($news['results'] as $new)
{
    echo $new['title'].'';
    echo $new['abstract'].'';
    echo $new['url'].'';
}
```

For Times Newswire (Get News By URL)

```
/*
Parameters
$url (string),
*/

$url='https://www.nytimes.com/2025/08/25/arts/dance/kennedy-center-stephen-nakagawa.html';

$news=NYTimes::timesNewswireUrl($url)->get();

foreach ($news['results'] as $new)
{
    echo $new['title'].'';
    echo $new['abstract'].'';
}
```

Get News Sections

```
$sections=NYTimes::newsSectionList()->get();

foreach ($sections['results'] as $section)
{
    echo $section['section'].'';
    echo $section['display_name'].'';
}
```

For Top Stories

```
/*
Parameters
$sections (string),
*/

$stories=NYTimes::topStories('food')->get();

foreach ($stories['results'] as $story)
{
    echo $story['title'].'';
    echo $story['abstract'].'';
    echo $story['url'].'';
}
```

For RSS

```
/*
Parameters
$section (string),
*/

$feeds=NYTimes::rssFeed('Automobiles')->get();

echo $feeds['channel']['title'].'';

foreach ($feeds['channel']['item'] as $feed)
{
    echo $feed['title'].'';
    echo $feed['link'].'';
    echo $feed['description'].'';
}
```

```
// returns data in XML (toXML() Only valid for RSS Feed)
$feeds=NYTimes::rssFeed('Automobiles')->toXML();
header('Content-type: application/xml');
echo $feeds;
```

📌 Requirements
--------------

[](#-requirements)

PHP >= 7.4

Laravel 8, 9, 10, 11 or 12

NYTimes API Key (Free – Get one here ()

🤝 Contributing
--------------

[](#-contributing)

Contributions are welcome! Feel free to open an issue or submit a pull request to improve this package.

📜 License
---------

[](#-license)

This package is open-sourced software licensed under the MIT license.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance59

Moderate activity, may be stable

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

262d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/666995e9b5a1c0da5f8aa5aeaa737b949753235e5b0f77dd3067a250c54d4279?d=identicon)[Ehtisham](/maintainers/Ehtisham)

---

Top Contributors

[![ShamiTheWebdeveloper](https://avatars.githubusercontent.com/u/122912862?v=4)](https://github.com/ShamiTheWebdeveloper "ShamiTheWebdeveloper (14 commits)")

---

Tags

apilaravelpackage newsnytimes

### Embed Badge

![Health badge](/badges/shamithewebdeveloper-laravel-nytimes-api/health.svg)

```
[![Health](https://phpackages.com/badges/shamithewebdeveloper-laravel-nytimes-api/health.svg)](https://phpackages.com/packages/shamithewebdeveloper-laravel-nytimes-api)
```

###  Alternatives

[smodav/mpesa

M-Pesa API implementation

16363.7k1](/packages/smodav-mpesa)[joisarjignesh/bigbluebutton

BigBlueButton Server API Library for Laravel

162145.5k1](/packages/joisarjignesh-bigbluebutton)[bmatovu/laravel-mtn-momo

Laravel MTN MOMO integration.

14310.9k](/packages/bmatovu-laravel-mtn-momo)[ardakilic/mutlucell

Mutlucell SMS API wrapper for sending sms text messages for Laravel

457.3k](/packages/ardakilic-mutlucell)[gregoriohc/laravel-trello

A Laravel wrapper and facade package for the Trello API

3366.8k2](/packages/gregoriohc-laravel-trello)[dariusiii/tmdb-laravel

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

1821.1k](/packages/dariusiii-tmdb-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)