TwitterSharp 2.0.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package TwitterSharp --version 2.0.0                
NuGet\Install-Package TwitterSharp -Version 2.0.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="TwitterSharp" Version="2.0.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add TwitterSharp --version 2.0.0                
#r "nuget: TwitterSharp, 2.0.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install TwitterSharp as a Cake Addin
#addin nuget:?package=TwitterSharp&version=2.0.0

// Install TwitterSharp as a Cake Tool
#tool nuget:?package=TwitterSharp&version=2.0.0                


How does it works?

To begin with, please go to the Twitter Developer Portal and create a new application
Then you must instantiate a new client:

var client = new TwitterSharp.Client.TwitterClient(bearerToken);

From there you can access various methods to access tweets and users, however please make note that a basic request only includes:

  • For tweets: its ID and content
  • For users: its ID, name and username

To solve that, most function take an array of UserOption or TweetOption, make sure to add what you need there!

Need more help? You can use the examples below, if you're still lost feel free to open an issue or a discussion!


Get a tweet from its ID

var client = new TwitterSharp.Client.TwitterClient(bearerToken);
var answer = await client.GetTweetAsync("1389189291582967809");
Console.WriteLine(answer.Text); // たのしみ!!\uD83D\uDC93

Get an user from its username

var client = new TwitterSharp.Client.TwitterClient(bearerToken);
var answer = await client.GetUserAsync("theindra5");
Console.WriteLine(answer.Id); // 1022468464513089536

Get latest tweets from an user id with the attached medias

var client = new TwitterSharp.Client.TwitterClient(bearerToken);
// You can get the id using GetUsersAsync
var answer = await client.GetTweetsFromUserIdAsync("1109748792721432577", new TweetOption[] { TweetOption.Attachments }, null, new MediaOption[] { MediaOption.Url });
for (int i = 0; i < answer.Length; i++)
    var tweet = answer[i];
    Console.WriteLine($"Tweet n°{i}");
    if (tweet.Attachments?.Media?.Any() ?? false)
        Console.WriteLine(string.Join("\n", tweet.Attachments.Media.Select(x => x.Url)));

Get the users that someone follow

var client = new TwitterClient(Environment.GetEnvironmentVariable("TWITTER_TOKEN"));

var answer = await client.GetFollowingAsync("1433657158067896325", 1000);
Console.WriteLine(string.Join("\n", answer.Users.Select(u => u.Username)));
while (answer.NextAsync != null) // We go to the next page if there is one
    answer = await answer.NextAsync();
    Console.WriteLine(string.Join("\n", answer.Users.Select(u => u.Username)));

Continuously get all the new tweets from some users

var client = new TwitterSharp.Client.TwitterClient(bearerToken);

// Subscribe to 5 Twitter accounts
var request = new TwitterSharp.Request.StreamRequest(
    Expression.Author("moricalliope") // using TwitterSharp.Rule;
, "Anime");
await client.AddTweetStreamAsync(request); // Add them to the stream

// We display all the subscriptions we have
var subs = await client.GetInfoTweetStreamAsync();
Console.WriteLine("Subscriptions: " + string.Join("\n", subs.Select(x => x.Value.ToString())));

// NextTweetStreamAsync will continue to run in background
Task.Run(async () =>
    // Take in parameter a callback called for each new tweet
    // Since we want to get the basic info of the tweet author, we add an empty array of UserOption
    await client.NextTweetStreamAsync((tweet) =>
        Console.WriteLine($"From {tweet.Author.Name}: {tweet.Text} (Rules: {string.Join(',', tweet.MatchingRules.Select(x => x.Tag))})");
    }, null, Array.Empty<UserOption>());

// Add new high frequent rule after the stream started. No disconnection needed.
await client.AddTweetStreamAsync(new TwitterSharp.Request.StreamRequest( Expression.Author("Every3Minutes"), "Frequent"));


If you want to contribute feel free to open a pull request
You can also see how the project is going in the project tab

Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net5.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.4.0 7,702 12/9/2022
2.3.0 1,817 9/15/2022
2.2.0 2,692 7/15/2022
2.1.0 2,298 3/22/2022
2.0.0 641 3/15/2022
1.5.0 740 2/15/2022
1.4.0 481 2/6/2022
1.3.0 427 2/4/2022
1.2.0 346 1/13/2022
1.1.1 441 1/10/2022
1.1.0 273 1/5/2022
1.0.1 795 6/13/2021
1.0.0 417 6/11/2021
0.2.0-alpha 234 5/8/2021
0.1.0-alpha 244 5/7/2021
0.0.0-alpha 222 5/5/2021