twitter_api_v2 1.5.0 twitter_api_v2: ^1.5.0 copied to clipboard
The lightweight and powerful wrapper library for Twitter API v2.0 written in Dart language. It works cross-platform.
The Lightweight and Cross-Platform Wrapper for Twitter API v2.0 🐦
1. Guide #
This library provides the easiest way to use Twitter API v2.0.
Show some ❤️ and star the repo to support the project.
1.1. Getting Started #
1.1.1. Install Library #
With Dart:
dart pub add twitter_api_v2
Or With Flutter:
flutter pub add twitter_api_v2
1.1.2. Import #
import 'package:twitter_api_v2/twitter_api_v2';
1.1.3. Implementation #
import 'package:twitter_api_v2/twitter_api_v2.dart' as v2;
void main() async {
//! You need to get keys and tokens at https://developer.twitter.com
final twitter = v2.TwitterApi(
//! Authentication with OAuth2.0 is the default.
//!
//! Note that to use endpoints that require certain user permissions,
//! such as Tweets and Likes, you need a token issued by OAuth2.0 PKCE.
bearerToken: 'YOUR_TOKEN_HERE',
//! Or perhaps you would prefer to use the good old OAuth1.0a method
//! over the OAuth2.0 PKCE method. Then you can use the following code
//! to set the OAuth1.0a tokens.
//!
//! However, note that some endpoints cannot be used for OAuth 1.0a method
//! authentication.
oauthTokens: v2.OAuthTokens(
consumerKey: 'YOUR_CONSUMER_KEY_HERE',
consumerSecret: 'YOUR_CONSUMER_SECRET_HERE',
accessToken: 'YOUR_ACCESS_TOKEN_HERE',
accessTokenSecret: 'YOUR_ACCESS_TOKEN_SECRET_HERE',
),
);
try {
final me = await twitter.usersService.lookupMe();
final tweets = await twitter.tweetsService.searchRecent(query: '#ElonMusk');
final response = await twitter.tweetsService.createLike(
userId: me.data.id,
tweetId: tweets.data.first.id,
);
print(response);
} on v2.TwitterException catch (e) {
print(e.response.headers);
print(e.response.body);
}
}
1.2. Supported Endpoints #
-
Tweets Service
- Manage Tweet
- Likes
- Retweets
- Quote Tweets
- Search Tweets
- Lookup Tweets
- Tweet Counts
- Bookmarks
-
Users
-
Spaces
- Search Spaces
- Lookup Spaces
-
Lists
- Lookup Lists
Note:
Not all additional fields listed in the official documentation are supported. We intend to support them step by step.
Also you can create an Issue or Pull Request if you wish to suggest or contribute!
1.3. Contribution #
If you would like to contribute to twitter_api_v2
, please create an issue or create a Pull Request.
Owner will respond to issues and review pull requests as quickly as possible.
1.4. Support #
The simplest way to show us your support is by giving the project a star at here.
And I'm always looking for sponsors to support this project.
Sponsors can be individuals or corporations, and the amount is optional.
1.5. License #
All resources of twitter_api_v2
is provided under the BSD-3
license.
Note: License notices in the source are strictly validated based on
.github/header-checker-lint.yml
. Please check header-checker-lint.yml for the permitted standards.
1.6. More Information #
twitter_api_v2
was designed and implemented by Kato Shinya.