LinqToTwitter Wiki & Documentation Rss Feed

Updated Wiki: Services, Sites, and Software that Use LINQ to Twitter

JoeMayo — Fri, 24 May 2013 01:26:37 GMT

Services, Sites, and Software that Use LINQ to Twitter

Contact Joe Mayo via The CodePlex Contact Form or Twitter if you would like to add your link to this list:

New Comment on "Searching Twitter"

Neilski — Mon, 20 May 2013 16:14:34 GMT

I've just started to use the library, but when I create the Search object, it doesn't seem to present a 'Count' property. For example, if I want to get the three latest tweets: var srch = ( from search in twitterCtx.Search where search.Type == SearchType.Search && search.Query == "LINQ to Twitter" && search.Count == 7 // Property not available and will not compile select search ).SingleOrDefault(); What am I missing/doing wrong? Thanks.

New Comment on "Searching Twitter"

rye004 — Sun, 19 May 2013 05:38:28 GMT

Is it possible to make this go beyond the last 6 – 9 days of messages posted on twitter? I need to search for messages in 2010 and the API only goes back about a week.

New Comment on "Implementing OAuth for Desktop Applications"

Dave — Mon, 13 May 2013 10:26:48 GMT

I'd love to see a full working C# sample of this...

New Comment on "Status Entity"

JoeMayo — Fri, 10 May 2013 05:02:56 GMT

@mello702 - Thanks - updated.

New Comment on "Status Entity"

JoeMayo — Fri, 10 May 2013 05:02:33 GMT

@mandarj123 - The difference is whether it's an input or not. The input column for ID is yes, meaning that you can use it as a query parameter. Since you wouldn't want response data overwriting query parameters, I separate those into non-input result properties.

Updated Wiki: Status Entity

JoeMayo — Fri, 10 May 2013 05:00:05 GMT

Status Entity

The status entity contains properties about tweets. The input column designates whether the property is populated by the user and not Twitter (yes) or if it is a property populated by Twitter (no).

Properties:

Name	Purpose	Type	Input
Annotation	Meta-data applied to tweet	Annotation	no
CreatedAt	Tweet creation date (UTC)	DateTime	no
Contributors	List of contributors	List of Contributors	no
Coordinates	Coordinate information	Coordinates	no
Count	Number of tweets to return; max is 200	int	yes
CurrentUserRetweet	ID of source status of retweet if IncludeMyRetweet is true. Set to 0 if IncludeMyRetweet is false or tweet not retweeted by authenticating user	int	yes
Entities	Entities connected to the status	Entities	no
ExcludeReplies	Exclude tweet replies	bool	yes
FavoriteCount	Number of times the tweet was favorite	int?	no
Favorited	Whether the status is Favorited or not	bool	no
ID	Tweet ID	string	yes
IncludeContributorDetails	Include more than just contributor ID	bool	no
InReplyToScreenName	Screen name of user being replied to	string	no
InReplyToStatusID	ID of status being replied to	string	yes
InReplyToUserID	ID of user being replied to	string	no
MaxID	Return tweets earlier than or equal to this ID	ulong	yes
Page	Page to retrieve	int	yes
Place	Place where status was created	Place	no
PossiblySensitive	Whether tweet is possibly sensitive or not	bool	no
RetweetCount	Number of times retweeted	int	no
Retweeted	Whether status has been retweeted or not	bool	no
RetweetedStatus	Whether it was a retweet of a retweeted status	Status	no
ScreenName	Screen name	string	no
SinceID	Return tweets later than this ID	ulong	yes
Source	Source of the tweet	string	no
StatusID	Status ID	string	no
Text	Tweet text	string	no
TrimUser	Return only user status ID and tweet	bool	yes
Truncated	Whether the tweet is truncated or not	bool	no
User	User information	User	no
Users	List of User	List of User	no
UserID	User ID	string	yes

Twitter API: tweets

Updated Wiki: Status Entity

JoeMayo — Fri, 10 May 2013 04:58:30 GMT

Status Entity

The status entity contains properties about tweets. The input column designates whether the property is populated by the user and not Twitter (yes) or if it is a property populated by Twitter (no).

Properties:

Name	Purpose	Type	Input
Annotation	Meta-data applied to tweet	Annotation	no
CreatedAt	Tweet creation date (UTC)	string	no
Contributors	List of contributors	List of Contributors	no
Coordinates	Coordinate information	Coordinates	no
Count	Number of tweets to return; max is 200	int	yes
CurrentUserRetweet	ID of source status of retweet if IncludeMyRetweet is true. Set to 0 if IncludeMyRetweet is false or tweet not retweeted by authenticating user	int	yes
Entities	Entities connected to the status	Entities	no
ExcludeReplies	Exclude tweet replies	bool	yes
FavoriteCount	Number of times the tweet was favorite	int?	no
Favorited	Whether the status is Favorited or not	bool	no
ID	Tweet ID	string	yes
IncludeContributorDetails	Include more than just contributor ID	bool	no
InReplyToScreenName	Screen name of user being replied to	string	no
InReplyToStatusID	ID of status being replied to	string	yes
InReplyToUserID	ID of user being replied to	string	no
MaxID	Return tweets earlier than or equal to this ID	ulong	yes
Page	Page to retrieve	int	yes
Place	Place where status was created	Place	no
PossiblySensitive	Whether tweet is possibly sensitive or not	bool	no
RetweetCount	Number of times retweeted	int	no
Retweeted	Whether status has been retweeted or not	bool	no
RetweetedStatus	Whether it was a retweet of a retweeted status	Status	no
ScreenName	Screen name	string	no
SinceID	Return tweets later than this ID	ulong	yes
Source	Source of the tweet	string	no
StatusID	Status ID	string	no
Text	Tweet text	string	no
TrimUser	Return only user status ID and tweet	bool	yes
Truncated	Whether the tweet is truncated or not	bool	no
User	User information	User	no
Users	List of User	List of User	no
UserID	User ID	string	yes

Twitter API: tweets

Updated Wiki: Home

JoeMayo — Thu, 09 May 2013 14:40:49 GMT

LINQ to Twitter is an open source 3rd party LINQ Provider for the Twitter micro-blogging service. It uses standard LINQ syntax for queries and includes method calls for changes via the Twitter API.

Example

The following query returns search results where people are tweeting about LINQ to Twitter:

            var twitterCtx = new TwitterContext(...);

            var queryResults =
                from search in twitterCtx.Search
                where search.Type == SearchType.Search &&
                      search.Query == "Linq To Twitter"
                select search;

            Search srch = queryResults.Single();

            Console.WriteLine("\nQuery: {0}\n", srch.QueryResult);
            srch.Statuses.ForEach(entry =>
                Console.WriteLine(
                    "ID: {0, -15}, Source: {1}\nContent: {2}\n",
                    entry.StatusID, entry.Source, entry.Text));

From a coding experience perspective, the TwitterContext type is analogous to DataContext (LINQ to SQL) or ObjectContext (LINQ to Entities). You use the TwitterContext instance, twitterCtx, to access IQueryable<T> tweet categories. In the example above, the Search will give you the ability to search Twitter for tweets meeting some criteria.

Note: The ellipses in the TwitterContext parameters indicates that you need to provide an authorizer with credentials, which is required. You can visit Securing Your Applications for documentation on authorizers and visit the Download page for working examples.

Each query category has a Type property for the type of tweets you want to get back. For example, Status tweets can be made for Home, Mentions, or User timelines. Each query category also has an XxxType enum to help you figure out what is available. The example above uses SearchType.Search to perform searches. Another example would be Status queries which might have StatusType.Home as its Type. In the case of Search queries, Search is the only option, but the Type idiom is consistent accross all query categories.

Just like other LINQ providers, you get an IQueryable<T> back from the query. You can see how to materialize the query by invoking the Single operator. For Search results, you receive one Search entity that contains information about the Search query and the Search entity contains a Results property that is a collection of SearchResult entities. On other queries, you would materialize the query with ToList for multiple results. Just like other LINQ providers, LINQ to Twitter does deferred execution, so operators such as ToList and Single or statements such as for and foreach loops will cause the query to execute and make the actual call to Twitter.

For more details on how LINQ to Twitter works, you can either click on the Documentation menu (above) or visit Making API Calls for API specific examples. The downloadable source code also contains copious examples in the LinqToTwitterDemo project.

For the latest news, follow Joe Mayo on Twitter.

NuGet

In addition to being able to download from this site, you can also automatically install LINQ to Twitter into your Visual Studio projects via NuGet;

For help in getting started with NuGet: A Gentle Introduction to NuGet.

Samples

LINQ to Twitter Samples contains example code for using LINQ to Twitter with various .NET technologies.

Who is Using LINQ to Twitter?

Services, Sites, and Software that Use LINQ to Twitter

Available Feature Set

See Making API Calls.

Follow Joe on Twitter

Updated Wiki: Home

JoeMayo — Thu, 09 May 2013 14:33:47 GMT

LINQ to Twitter is an open source 3rd party LINQ Provider for the Twitter micro-blogging service. It uses standard LINQ syntax for queries and includes method calls for changes via the Twitter API.

Example

You can try LINQ to Twitter, even if you don't have a twitter account. The following query returns search results where people are tweeting about LINQ to Twitter:

            var twitterCtx = new TwitterContext(...);

            var queryResults =
                from search in twitterCtx.Search
                where search.Type == SearchType.Search &&
                      search.Query == "Linq To Twitter"
                select search;

            Search srch = queryResults.Single();

            Console.WriteLine("\nQuery: {0}\n", srch.QueryResult);
            srch.Statuses.ForEach(entry =>
                Console.WriteLine(
                    "ID: {0, -15}, Source: {1}\nContent: {2}\n",
                    entry.StatusID, entry.Source, entry.Text));

NuGet

Samples

LINQ to Twitter Samples contains example code for using LINQ to Twitter with various .NET technologies.

Who is Using LINQ to Twitter?

Services, Sites, and Software that Use LINQ to Twitter

Available Feature Set

See Making API Calls.

Follow Joe on Twitter

Updated Wiki: Updating Friendship Settings

JenniferMayo — Mon, 29 Apr 2013 20:58:54 GMT

Updating Friendship Settings

Update notification settings.

Signature:

public Friendship UpdateFriendshipSettings(string screenName, bool retweets, bool device);
public static Friendship UpdateFriendshipSettings(ulong userID, bool retweets, bool device);
public Friendship UpdateFriendshipSettings(ulong userID, string screenName, bool retweets, bool device, Action<TwitterAsyncResponse<Friendship>> callback);

Parameters/Filters:

Name	Purpose	Type	Required
device	Receive device notifications about followed user	bool	no
retweets	Receive retweets from followed user	bool	no
screenName	Screen name of user to follow	string	only if UserID is empty
userID	ID of user to follow	string	only if ScreenName is empty

Note: userID or screenName must be provided.

Return Type: User

Example:

Friendship friend = twitterCtx.UpdateFriendshipSettings("JoeMayo", /*retweets:*/ true,
                                                        /*device:*/ true);

Console.WriteLine("Settings for {0} are: Can Retweet is {1}" + 
    "Can Send Device Notifications is {2}",
    friend.SourceRelationship.ScreenName, 
    friend.SourceRelationship.RetweetsWanted, 
    friend.SourceRelationship.NotificationsEnabled);

Twitter API: friendships update

Updated Wiki: Creating a Friendship

JenniferMayo — Mon, 29 Apr 2013 20:58:28 GMT

Creating a Friendship

Follow another user.

Signature:

public User CreateFriendship(string userID, string screenName, bool follow);
public User CreateFriendship(string userID, string screenName, bool follow, Action<TwitterAsyncResponse<User>> callback);

Parameters/Filters:

Name	Purpose	Type	Required
follow	Receive notifications about followed user	bool	no
screenName	Screen name of user to follow	string	only if UserID is empty
userID	ID of user to follow	string	only if ScreenName is empty

Note: UserID or ScreenName must be provided.

Return Type: User

Example:

var user = twitterCtx.CreateFriendship("JoeMayo", null, true);

Console.WriteLine(
    "User Name: {0}, Status: {1}",
    user.Name,
    user.Status.Text);

Twitter API: friendships create

Updated Wiki: Destroying Direct Messages

JenniferMayo — Mon, 29 Apr 2013 20:57:38 GMT

Destroying Direct Messages

Delete a direct message.

Requires Authentication: Yes
Rate Limited: No

Signature:

public static DirectMessage DestroyDirectMessage(string id, bool includeEntites);
public static DirectMessage DestroyDirectMessage(string id, bool includeEntites,
Action<TwitterAsyncResponse<DirectMessage>> callback);

Parameters/Filters:

Name	Purpose	Type	Required
id	ID of direct message to delete	string	yes
includeEntities	Include Twitter entities	bool	no

Return Type: DirectMessage

Example:

            var message = twitterCtx.DestroyDirectMessage("189178687374110720");

            if (message != null)
            {
                Console.WriteLine(
                    "Recipient: {0}, Message: {1}",
                    message.RecipientScreenName,
                    message.Text);
            }

Twitter API: direct_messages destroy

Updated Wiki: Sending Direct Messages

JenniferMayo — Mon, 29 Apr 2013 20:57:18 GMT

Sending Direct Messages

Send a direct message.

Signature:

public DirectMessage NewDirectMessage(string user, string text);
public DirectMessage NewDirectMessage(string user, string text, Action<TwitterAsyncResponse<DirectMessage>> callback)

Parameters/Filters:

Name	Purpose	Type	Required
text	Text of message to send	string	yes
user	ScreenName or ID of user	string	yes

Return Type: DirectMessage

Example:

var message = twitterCtx.NewDirectMessage("16761255", "Direct Message Test - " 
                                          + DateTime.Now);

if (message != null)
{
    Console.WriteLine(
        "Recipient: {0}, Message: {1}, Date: {2}",
        message.RecipientScreenName,
        message.Text,
        message.CreatedAt);
}

Twitter API: direct_messages new

Updated Wiki: Retweeting a Status

JenniferMayo — Mon, 29 Apr 2013 20:55:37 GMT

Retweeting a Status

Performs a retweet of a tweet.

Signature:

public Status Retweet(string id); 
public Status Retweet(string id, Action<TwitterAsyncResponse<Status>> callback);

Parameters/Filters:

Name	Purpose	Type	Required
id	ID of tweet to retweet	string	yes

Return Type: Status

Example:

            var retweet = twitterCtx.Retweet("11515561768");

            Console.WriteLine("\nStatus being retweeted: \n\n\{0}\"",                    
                              retweet.Retweet.Text);
            Console.Write("\nDo you want to retweet this status? (y or n): ");
            string confirm = Console.ReadLine();
            
            if (confirm.ToUpper() == "N")
            {
                Console.WriteLine("\nThis status is *not* being retweeted.");
            }
            else if (confirm.ToUpper() == "Y")
            {
                Console.WriteLine("\nPress any key to retweet...\n");
                Console.ReadKey();

                Console.WriteLine("Retweeted Tweet: ");
                Console.WriteLine(
                    "\nUser: " + retweet.Retweet.RetweetedUser.Name +
                    "\nTweet: " + retweet.Retweet.Text +
                    "\nTweet ID: " + retweet.Retweet.ID + "\n");
            }
            else
            {
                Console.WriteLine("Not a valid entry.");
            }

Twitter API: statuses retweet

Updated Wiki: Destroying Statuses

JenniferMayo — Mon, 29 Apr 2013 20:55:14 GMT

Destroying Statuses

Deletes a tweet.

Signature:

public Status DestroyStatus(string id);
public Status DestroyStatus(string id);
public Status DestroyStatus(string id, Action<TwitterAsyncResponse<Status>> callback);

Parameters/Filters:

Name	Purpose	Type	Required
id	Tweet ID to retrieve	ulong	yes

Return Type: Status

Example:

            Console.WriteLine("This demo will post a test status and show its ID." + 
                              "Then, the status will be destroyed."\n");

            Console.Write("Enter your test status update: ");
            string status = Console.ReadLine();

            Console.WriteLine("\nStatus being sent: \n\n\"{0}\"", status);

            Console.WriteLine("\nPress any key to post tweet...\n");
            Console.ReadKey();

            var tweet = twitterCtx.UpdateStatus(status);

            Console.WriteLine(
                "Status returned: " +
                "(" + tweet.StatusID + ")" +
                tweet.User.Name + ", " +
                tweet.Text + "\n");

            Console.WriteLine("Status ID: " + tweet.StatusID);
            Console.WriteLine("\nThis ID will be used to delete the status.");

            Console.WriteLine("\nStatus being destroyed: \n\n\"{0}\"", status);
            Console.Write("\nDo you want to destroy this status? (y or n): ");
            string confirm = Console.ReadLine();

            if (confirm.ToUpper() == "N")
            {
                Console.WriteLine("\nThis status is *not* being destroyed.");
            }
            else if (confirm.ToUpper() == "Y")
            {
                var destroy = twitterCtx.DestroyStatus(tweet.StatusID);

                Console.WriteLine("\nPress any key to destroy...\n");
                Console.ReadKey();

                Console.WriteLine(
                    "(" + destroy.StatusID + ")" +
                    destroy.User.Name + ", " +
                    destroy.Text + " was destroyed.");
            }
            else
            {
                Console.WriteLine("Not a valid entry.");
            }

Twitter API: statuses destroy

Updated Wiki: Updating Statuses

JenniferMayo — Mon, 29 Apr 2013 20:54:55 GMT

Updating Statuses

Creates a new tweet.

Signatures (overloads):

public Status UpdateStatus(string status);
public Status UpdateStatus(string status, string inReplyToStatusID);
public Status UpdateStatus(string status, string inReplyToStatusID, Action<TwitterAsyncResponse<Status>> callback);
public Status UpdateStatus(string status, decimal latitude, decimal longitude, Action<TwitterAsyncResponse<Status>> callback);
public Status UpdateStatus(string status, decimal latitude, decimal longitude, bool displayCoordinates, Action<TwitterAsyncResponse<Status>> callback);
public Status UpdateStatus(string status, decimal latitude, decimal longitude, bool displayCoordinates, string inReplyToStatusID, Action<TwitterAsyncResponse<Status>> callback);
public Status UpdateStatus(string status, decimal latitude, decimal longitude, string placeID, Action<TwitterAsyncResponse<Status>> callback);
public Status UpdateStatus(string status, decimal latitude, decimal longitude, string placeID, string inReplyToStatusID, Action<TwitterAsyncResponse<Status>> callback);
public Status UpdateStatus(string status, decimal latitude, decimal longitude, string placeID, bool displayCoordinates, Action<TwitterAsyncResponse<Status>> callback);
public Status UpdateStatus(string status, string placeID, bool displayCoordinates, Action<TwitterAsyncResponse<Status>> callback);
public Status UpdateStatus(string status, string placeID, bool displayCoordinates, string inReplyToStatusID, Action<TwitterAsyncResponse<Status>> callback);
public Status UpdateStatus(string status, decimal latitude, decimal longitude, string placeID, bool displayCoordinates, string inReplyToStatusID, Action<TwitterAsyncResponse<Status>> callback);

Parameters/Filters:

Name	Purpose	Type	Required
displayCoordinates	Choose whether location info should appear in this specific tweet; defaults to false.	bool	no
inReplyToStatusID	ID or screen name of user replied to.	string	no
latitude	Latitude location coordinate.	decimal	no
longitude	Logitude location coordinage.	decimal	no
placeID	ID of place (can be obtained via reverse geo lookup (Geo.Reverse in LINQ to Twitter).	string	no
status	Text for new tweet. Must be 140 characters or less in length.	string	yes

Note: When replying to a tweet, use an overload that uses InReplyToStatusID, which is the Status ID of the tweet being replied to. Also, it's important to include the Screen Name, @ScreenName, of the user being replied to as part of the tweet text, Status.

Return Type: Status

Example:

            Console.Write("Enter your status update: ");
            string status = Console.ReadLine();

            Console.WriteLine("\nStatus being sent: \n\n\"{0}\"", status);
            Console.Write("\nDo you want to update your status? (y or n): ");
            string confirm = Console.ReadLine();

            if (confirm.ToUpper() == "N")
            {
                Console.WriteLine("\nThis status is *not* being sent.");
            }
            else if (confirm.ToUpper() == "Y")
            {
                Console.WriteLine("\nPress any key to post tweet...\n");
                Console.ReadKey();

                var tweet = twitterCtx.UpdateStatus(status);

                Console.WriteLine(
                    "Status returned: " +
                    "(" + tweet.StatusID + ")" +
                    tweet.User.Name + ", " +
                    tweet.Text + "\n");
            }
            else
            {
                Console.WriteLine("Not a valid entry.");
            }

Twitter API: statuses update

New Comment on "Querying the Mentions Timeline"

Legionaire — Wed, 24 Apr 2013 02:42:12 GMT

I have a quick question, after i get my mentions in a list what method will I use to make a reply? because all i see is "replywithmedia"?? I appreciate any advice anyone can offer...Code On!!

Updated Wiki: Finding Owned Lists

JoeMayo — Tue, 23 Apr 2013 05:10:36 GMT

Finding Owned Lists

Get lists that the authenticated user owns.

Entity: List
Type: ListType.Ownerships

Parameters/Filters:

Name	Purpose	Type	Required
Count	Results per page	int	no
Cursor	Token for paging through list	string	no
ScreenName	Screen name of user	string	only if UserID is empty
UserID	ID of user	string	only if ScreenName is empty

Note: Either UserID or ScreenName is required.

Example:

            var lists =
                (from list in twitterCtx.List
                 where list.Type == ListType.Ownerships &&
                       list.ScreenName == "Linq2Tweeter"
                 select list)
                .ToList();

            foreach (var list in lists)
            {
                Console.WriteLine("ID: {0}  Slug: {1} Description: {2}",
                    list.ListIDResult, list.SlugResult, list.Description);
            }

Twitter API: lists ownerships

Updated Wiki: Managing Lists

JoeMayo — Tue, 23 Apr 2013 05:07:54 GMT

Managing Lists

Lists allow you to categorize Twitter accounts.