Lists
The Lists endpoint let's you create and manage lists of Twitter users.
Getting details about a single list
Using the GetList method, you can request the details about a specific list. For instance 956229313061367809 as shown in the example below, is the ID of my example list.
@using Skybrud.Social.Twitter.Models.Lists
@using Skybrud.Social.Twitter.Responses.Lists
@inherits WebViewPage<Skybrud.Social.Twitter.TwitterService>
@{
// Make the request to the Twitter API
TwitterListResponse response = Model.Lists.GetList(956229313061367809);
// Get the list details from the response body
TwitterList body = response.Body;
<pre>@body.Name</pre>
<pre>@body.Description</pre>
<pre>@body.SubscriberCount</pre>
<pre>@body.MemberCount</pre>
}
Getting the list of the authenticated user
In a similar way, you can use the GetLists method to get the lists of the authenticated user:
@using Skybrud.Social.Twitter.Models.Lists
@using Skybrud.Social.Twitter.Responses.Lists
@inherits WebViewPage<Skybrud.Social.Twitter.TwitterService>
@{
// Make the request to the Twitter API
TwitterListsResponse response = Model.Lists.GetLists();
// Iterate through the lists
foreach (TwitterList list in response.Body) {
<pre>@list.Id => @list.Name</pre>
}
}
Creating a new list
Also, you can use the CreateList method to create a new list. The Twitter API will then respond with the details about the new list:
@using Skybrud.Social.Twitter.Models.Lists
@using Skybrud.Social.Twitter.Responses.Lists
@inherits WebViewPage<Skybrud.Social.Twitter.TwitterService>
@{
// Make the request to the Twitter API
TwitterCreateListResponse response = Model.Lists.CreateList("Hest");
// Get the list details from the response body
TwitterList body = response.Body;
<pre>@body.Name</pre>
<pre>@body.Description</pre>
<pre>@body.SubscriberCount</pre>
<pre>@body.MemberCount</pre>
}
Deleting a list
If you no longer need one of your lists, you can use the DeleteList method for deleting that particular list. Even though the request will delete the list, the Twitter will like the examples above still return the details about the list.
@using Skybrud.Social.Twitter.Models.Lists
@using Skybrud.Social.Twitter.Responses.Lists
@inherits WebViewPage<Skybrud.Social.Twitter.TwitterService>
@{
// Make the request to the Twitter API
TwitterDeleteListResponse response = Model.Lists.DeleteList(956229313061367809);
// Get the list details from the response body
TwitterList body = response.Body;
<pre>@body.Name</pre>
<pre>@body.Description</pre>
<pre>@body.SubscriberCount</pre>
<pre>@body.MemberCount</pre>
}
Adding a member to a list
Either by the ID of the user (the first parameter is the ID of the list, while the second parameter the is ID of the user):
@using Skybrud.Social.Twitter.Responses.Lists
@inherits WebViewPage<Skybrud.Social.Twitter.TwitterService>
@{
// Make the request to the API
TwitterAddMemberResponse response = Model.Lists.AddMember(956229313061367809, 319219802);
// Get the list details from the response body
TwitterList body = response.Body;
<pre>@body.Name</pre>
<pre>@body.Description</pre>
<pre>@body.SubscriberCount</pre>
<pre>@body.MemberCount</pre>
}
or by the screen name of the user:
@using Skybrud.Social.Twitter.Responses.Lists
@inherits WebViewPage<Skybrud.Social.Twitter.TwitterService>
@{
// Make the request to the API
TwitterAddMemberResponse response = Model.Lists.AddMember(956229313061367809, "abjerner");
// Get the list details from the response body
TwitterList body = response.Body;
<pre>@body.Name</pre>
<pre>@body.Description</pre>
<pre>@body.SubscriberCount</pre>
<pre>@body.MemberCount</pre>
}
Removing a member from a list
Similar to adding a new member, you can also remove a member from the list (the first parameter is the ID of the list, while the second parameter the is ID of the user):
@using Skybrud.Social.Twitter.Responses.Lists
@inherits WebViewPage<Skybrud.Social.Twitter.TwitterService>
@{
// Make the request to the API
TwitterRemoveMemberResponse response = Model.Lists.RemoveMember(956229313061367809, 319219802);
// Get the list details from the response body
TwitterList body = response.Body;
<pre>@body.Name</pre>
<pre>@body.Description</pre>
<pre>@body.SubscriberCount</pre>
<pre>@body.MemberCount</pre>
}
or by the screen name:
@using Skybrud.Social.Twitter.Responses.Lists
@inherits WebViewPage<Skybrud.Social.Twitter.TwitterService>
@{
// Make the request to the API
TwitterRemoveMemberResponse response = Model.Lists.RemoveMember(956229313061367809, "abjerner");
// Get the list details from the response body
TwitterList body = response.Body;
<pre>@body.Name</pre>
<pre>@body.Description</pre>
<pre>@body.SubscriberCount</pre>
<pre>@body.MemberCount</pre>
}```