19th October, 2009 – version 1.0.0.4

• Added version 1.0.0.4
• Added new method to retrieve a user’s details via his/her screen Id.

  public UserDetails GetUserDetails (string userId)

• Added new method to retrieve a specified user’s list of followers. Returns a List<string> of all the user id’s that follow the specified user.

  public List<string> GetFollowerIdsForUser (string userId)

I could have given a method to get all the followers for a user, but that is quite an intensive query as it needs to first get all the id’s and then for each id, retrieve the users details. Instead I’ve separated the method to two general calls so that you can use it as you see fit.

I believe this does NOT go against your API rate limit.

13th August, 2009 – version 1.0.0.3

• Version 1.0.0.3
• Added an early release of Search capability to the Twitter API
• Added a new method called GetSearch to the interface:

  public SyndicationFeed GetSearch(SearchParameters parameters)

NOTE1:

New object called SearchParameters that has the following properties:

        public int TweetsPerPage { get; set; }
        public int Page{ get; set;}
        public string MoreRecentThanId { get; set; }
        public string SearchTerm { get; set; }

Refer to http://apiwiki.twitter.com/Twitter-Search-API-Method%3A-search for details on syntax for each of the parameters.

NOTE2:

This returns back a System.ServiceModel.Syndication.SyndicationFeed object that encapsulates an ATOM feed. (I haven’t got Json working yet heh).

As an example, to search for #wordpress, you can call the search as follows:

    TwitterAPI.Interface api = new Interface(userName, userPassword);
    SearchParameters parameters = new SearchParameters("%23wordpress");

    SyndicationFeed feed = api.GetSearch(parameters);

    Console.WriteLine(string.Format("Number of Items: {0}", feed.Items.Count().ToString()));

    foreach (SyndicationItem item in feed.Items)
    {
        Console.WriteLine(string.Format("{0}: {1}",
            item.PublishDate.ToString(),
            item.Title.Text
            ));
    }

NOTE3:

• The SearchTerm parameter must be less than 140 chars URL encoded
• TweetsPerPage is limited to a maximum of 100
• Maximum number of search items that can be returned will be 1500.

 

22nd June, 2009 – version 1.0.0.2

• Version 1.0.0.2
• Added Last Tweet details to the UserDetails object:

  public DateTime LastTweetCreatedAt { get; set; }
  public string LastTweetId { get; set; }
  public string LastTweetText { get; set; }
  public string LastTweetSource { get; set; }
  public string LastTweetInReplyToScreenName { get; set; }

• Added new method called VerifyCredentials() that takes a username and password and returns back a UserDetails object if it authenticates correctly:

  public UserDetails VerifyCredentials()

• Added new method called GetRateLimitStatus() that returns back a RateLimitStatus object:

public RateLimitStatus GetRateLimitStatus()

//properties
public XmlDocument SourceXml { get; set; }

public int RemainingHits { get; set; }
public int HourlyLimit { get; set; }
public DateTime ResetTime { get; set; }
public int ResetTimeInSeconds { get; set; }

 

 

19th June, 2009

• Version 1.0.0.1
• Added new class in Interface for optional parameters – called ServiceParameters.

  public string MoreRecentThanId { get; set; }
  public string LessRecentThanId { get; set; }
  public int Count { get; set; }
  public int Page { get; set; }

• GetFriendsTweets changed to cater for optional parameters. Now provides following overloads:

  public Tweets GetFriendsTweets()
  public Tweets GetFriendsTweets(int count)
  public Tweets GetFriendsTweets(string moreRecentThanId)
  public Tweets GetFriendsTweets(ServiceParameters parameters)

• New Method: GetTweets – requires a screenName as a parameter. Gets Tweets that that user has sent. Can specify optional parameters. Has following overloads:

  public Tweets GetTweets(string screenName)
  public Tweets GetTweets(string screenName, int count)
  public Tweets GetTweets(string screenName, string moreRecentThanId)
  public Tweets GetTweets(string screenName, ServiceParameters parameters)

• Added three new public properties to the Tweet class:

  public string InReplyToTweetId { get; set; }
  public string InReplyToUserId { get; set; }
  public string InReplyToScreenName { get; set; }

• New Method: GetMentions – Gets the most recent mentions (status containing @username) for the authenticating user.

  public Mentions GetMentions()
  public Mentions GetMentions(int count)
  public Mentions GetMentions(string moreRecentThanId)
  public Mentions GetMentions(ServiceParameters parameters)

• New Method: GetFollowers – Gets the followers of the specified user, each with their current status line. Ordered by the order in which they joined Twitter. Shows 100 at a time, but can use the page parameter to access earlier followers

  public Followers GetFollowers()
  public Followers GetFollowers(int page)
  public Followers GetFollowers(string screenName)
  public Followers GetFollowers(string screenName, int page)

• New Class to handle Url Shortening: UrlShorteningService.cs. Note: Currently provides for shortening from http://tinyurl.com and http://u.nu/

  public static string MakeTinyUrl(string url)
  public static string MakeUnuUrl(string url)

• Changed GetFriends Methods to incorporate additional parameters as below:

  public Friends GetFriends()
  public Friends GetFriends(int page)
  public Friends GetFriends(string screenName)
  public Friends GetFriends(string screenName, int page)

18th June, 2009

• Version 1.0.0.0
• Initial Alpha Preview Release.