PHPackages                             thatzad/birder - 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. [Search &amp; Filtering](/categories/search)
4. /
5. thatzad/birder

ActiveLibrary[Search &amp; Filtering](/categories/search)

thatzad/birder
==============

Get and filter Tweets (by @user or #hashtag) in a Laravel Way

v0.1(12y ago)7902MITPHPPHP &gt;=5.3.0

Since Nov 27Pushed 9y ago1 watchersCompare

[ Source](https://github.com/Thatzad/Birder)[ Packagist](https://packagist.org/packages/thatzad/birder)[ RSS](/packages/thatzad-birder/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (1)Dependencies (3)Versions (3)Used By (0)

Birder
======

[](#birder)

Installation
------------

[](#installation)

Begin by installing this package through Composer. Go to your project folder from the terminal and execute: `composer require thatzad/birder`

Once this operation completes, the next step is to add the service provider. Open `app/config/app.php`, and add a new item to the providers array.

```
'Thatzad\Birder\BirderServiceProvider'

```

And add the alias.

```
'Birder' => 'Thatzad\Birder\Facades\BirderFacade'

```

Finally you'll need to publish the config file. To do that, in the project folder execute:

```
php artisan vendor:publish

```

This will output the configuration in your config folder. You must to fill all twitter fields.

Usage
-----

[](#usage)

If you're familiar in the Laravel world, you'll find that very easy to use. E.g., imagine you need to find all @dotZecker tweets that have more than 2 retweets and only 1 fav. Do this is as easy as:

```
$tweets = Birder::user('@dotZecker')
    ->where('retweets', '>', 2)
    ->where('favorites', '=', 1) // The same as: ->whereFavorites(1)
    ->get();

```

Now, you want to get all tweets by the #Zelda hashtag that have more than 5 retweets or more than 6 favs.

```
$tweets = Birder::hashtag('#Zelda')
    ->where('retweets', '>', 5)
    ->orWhere('favorites', '>', 6)
    ->get();

```

This will return you a [Illuminate\\Support\\Collection](http://laravel.com/api/5.0/Illuminate/Support/Collection.html), by this way you'll be able to use all these methods.

Are you British or lazy?
------------------------

[](#are-you-british-or-lazy)

Don't worry!, Birder uses internal synonyms (alias) for the favorites and retweets.

You can use:

`->where('favorites' ...)`, `->where('favourites' ...)`, `->where('favs' ...)`, `->whereFavourites(...)`, ...

`->where('retweets' ...)`, `->where('rts' ...)`, `->whereRts(...)`, ...

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 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

4551d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/1e1b70b2476930e7a394a09d09ee2eea487514acb4dbda6d4dc8b1da2caa607f?d=identicon)[rgomezcasas](/maintainers/rgomezcasas)

---

Top Contributors

[![rgomezcasas](https://avatars.githubusercontent.com/u/1331435?v=4)](https://github.com/rgomezcasas "rgomezcasas (24 commits)")

---

Tags

laravelfiltertwittertweet

### Embed Badge

![Health badge](/badges/thatzad-birder/health.svg)

```
[![Health](https://phpackages.com/badges/thatzad-birder/health.svg)](https://phpackages.com/packages/thatzad-birder)
```

###  Alternatives

[kyslik/laravel-filterable

Using URL query strings to filter Eloquent queries.

11539.0k](/packages/kyslik-laravel-filterable)[stolz/laravel-html-tidy

HTML Tidy middleware for Laravel

268.7k](/packages/stolz-laravel-html-tidy)

PHPackages © 2026

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