plugrbase/laravel-twitter-api

Twitter API wrapper for Laravel 8.x|9.x

v0.9.9 2022-06-16 09:48 UTC

Requires

• php: ^7.4|^8.0
• guzzlehttp/guzzle: ^7.4
• guzzlehttp/oauth-subscriber: ^0.6.0

Requires (Dev)

• nunomaduro/phpinsights: ^2.1
• orchestra/testbench: ^6.24
• phpunit/phpunit: ^9.0

MIT

• Julien Legrand

• plugrbase
• laravel-twitter-api

README

A very small package providing some functions to access the Twitter V2 API.

Installation

You can install the package via composer:

composer require plugrbase/laravel-twitter-api

Optionally publish the config file of this package:

php artisan vendor:publish --provider="Plugrbase\TwitterApi\TwitterApiServiceProvider"

Add the following environment variables.

TWITTER_API_CONSUMER_KEY=
TWITTER_API_CONSUMER_KEY_SECRET=
TWITTER_BEARER_TOKEN=
TWITTER_ACCESS_TOKEN=
TWITTER_TOKEN_SECRET=
TWITTER_API_URL=

Functions

Twitter API v2

• $twitterApi = new TwitterApi($bearerToken, $oAuthCredentials); - Create a new instance. If the oauth credentials are not passed, then the application config variables we'll be used instead (if provided).

Tweet

• $twitterApi->tweet()->get($tweetId) - Return a single Tweet.
• $twitterApi->tweet()->get($tweetId, ['expansions' => 'referenced_tweets.id.author_id','place.fields' => 'contained_within,country']); - Return a single Tweet with optional query parameters.
• $twitterApi->tweet()->getMany([$tweetId1, $tweetId2]) - Return multiple Tweets.
• $twitterApi->tweet()->create($params) - Create a Tweet. ex $params = ["text": "Hello World!"];

User

• $twitterApi->user()->get($userId) - Return a single user.
• $twitterApi->user()->get($userId, , ['user.fields' => 'created_at']); - Return a single user with optional query parameters.
• $twitterApi->user()->getMany([$userId1, $userId2]) - Return multiple users.
• $twitterApi->user()->getByUsername($username) - Return a single user by username.
• $twitterApi->user()->getManyByUsername([$username1, $username2]) - Return multiple users by username.
• $twitterApi->user()->getFollowers($userId) - Return all the followers of a user.
• $twitterApi->user()->getFollowers($userId, ['max_results' => 5]) - Return the five earliest followers of a user.
• $twitterApi->user()->getTweets($userId) - Return all the tweets of a user. By default, the most recent ten Tweets are returned per request. Using pagination, the most recent 3,200 Tweets can be retrieved.
• $twitterApi->user()->getTweets($userId, ['max_results' => 5]) - Return the five earliest tweets of a user.

Testing

composer test

Changelog

Please see CHANGELOG for more information what has changed recently.

License

The MIT License (MIT). Please see License File for more information.