Web.Twitter.Conduit.Api

Status

type StatusesMentionsTimeline = '["count" := Integer, "since_id" := Integer, "max_id" := Integer, "trim_user" := Bool, "contributor_details" := Bool, "include_entities" := Bool, "tweet_mode" := TweetMode]

statusesMentionsTimeline :: APIRequest StatusesMentionsTimeline [Status]

Returns query data asks the most recent mentions for the authenticating user.

You can perform a query using call:

res <- call mentionsTimeline

>>> statusesMentionsTimeline
APIRequest "GET" "https://api.twitter.com/1.1/statuses/mentions_timeline.json" []

type StatusesUserTimeline = '["count" := Integer, "since_id" := Integer, "max_id" := Integer, "trim_user" := Bool, "exclude_replies" := Bool, "contributor_details" := Bool, "include_rts" := Bool, "tweet_mode" := TweetMode]

statusesUserTimeline :: UserParam -> APIRequest StatusesUserTimeline [Status]

Returns query data asks a collection of the most recent Tweets posted by the user indicated by the screen_name or user_id parameters.

You can perform a search query using call:

res <- call $ userTimeline (ScreenNameParam "thimura")

>>> statusesUserTimeline (ScreenNameParam "thimura")
APIRequest "GET" "https://api.twitter.com/1.1/statuses/user_timeline.json" [("screen_name","thimura")]
>>> statusesUserTimeline (ScreenNameParam "thimura") & #include_rts ?~ True & #count ?~ 200
APIRequest "GET" "https://api.twitter.com/1.1/statuses/user_timeline.json" [("count","200"),("include_rts","true"),("screen_name","thimura")]

type StatusesHomeTimeline = '["count" := Integer, "since_id" := Integer, "max_id" := Integer, "trim_user" := Bool, "exclude_replies" := Bool, "contributor_details" := Bool, "include_entities" := Bool, "tweet_mode" := TweetMode]

statusesHomeTimeline :: APIRequest StatusesHomeTimeline [Status]

Returns query data asks a collection of the most recentTweets and retweets posted by the authenticating user and the users they follow.

You can perform a search query using call:

res <- call homeTimeline

>>> statusesHomeTimeline
APIRequest "GET" "https://api.twitter.com/1.1/statuses/home_timeline.json" []
>>> statusesHomeTimeline & #count ?~ 200
APIRequest "GET" "https://api.twitter.com/1.1/statuses/home_timeline.json" [("count","200")]

type StatusesRetweetsOfMe = '["count" := Integer, "since_id" := Integer, "max_id" := Integer, "trim_user" := Bool, "include_entities" := Bool, "include_user_entities" := Bool, "tweet_mode" := TweetMode]

statusesRetweetsOfMe :: APIRequest StatusesRetweetsOfMe [Status]

Returns query data asks the most recent tweets authored by the authenticating user that have been retweeted by others.

You can perform a search query using call:

res <- call retweetsOfMe

>>> statusesRetweetsOfMe
APIRequest "GET" "https://api.twitter.com/1.1/statuses/retweets_of_me.json" []
>>> statusesRetweetsOfMe & #count ?~ 100
APIRequest "GET" "https://api.twitter.com/1.1/statuses/retweets_of_me.json" [("count","100")]

type StatusesRetweetsId = '["count" := Integer, "trim_user" := Bool, "tweet_mode" := TweetMode]

statusesRetweetsId :: StatusId -> APIRequest StatusesRetweetsId [RetweetedStatus]

Returns query data that asks for the most recent retweets of the specified tweet

You can perform a search query using call:

res <- call twInfo mgr $ retweetsId 1234567890

>>> statusesRetweetsId 1234567890
APIRequest "GET" "https://api.twitter.com/1.1/statuses/retweets/1234567890.json" []
>>> statusesRetweetsId 1234567890 & #count ?~ 100
APIRequest "GET" "https://api.twitter.com/1.1/statuses/retweets/1234567890.json" [("count","100")]

type StatusesShowId = '["trim_user" := Bool, "include_my_retweet" := Bool, "include_entities" := Bool, "include_ext_alt_text" := Bool, "tweet_mode" := TweetMode]

statusesShowId :: StatusId -> APIRequest StatusesShowId Status

Returns query data asks a single Tweet, specified by the id parameter.

You can perform a search query using call:

res <- call twInfo mgr $ showId 1234567890

>>> statusesShowId 1234567890
APIRequest "GET" "https://api.twitter.com/1.1/statuses/show/1234567890.json" []
>>> statusesShowId 1234567890 & #include_my_retweet ?~ True
APIRequest "GET" "https://api.twitter.com/1.1/statuses/show/1234567890.json" [("include_my_retweet","true")]

type StatusesDestroyId = '["trim_user" := Bool, "tweet_mode" := TweetMode]

statusesDestroyId :: StatusId -> APIRequest StatusesDestroyId Status

Returns post data which destroys the status specified by the require ID parameter.

You can perform a search query using call:

res <- call twInfo mgr $ destroyId 1234567890

>>> statusesDestroyId 1234567890
APIRequest "POST" "https://api.twitter.com/1.1/statuses/destroy/1234567890.json" []

type StatusesUpdate = '["in_reply_to_status_id" := Integer, "display_coordinates" := Bool, "trim_user" := Bool, "media_ids" := [Integer], "tweet_mode" := TweetMode]

statusesUpdate :: Text -> APIRequest StatusesUpdate Status

Returns post data which updates the authenticating user's current status. To upload an image to accompany the tweet, use updateWithMedia.

You can perform a search query using call:

res <- call twInfo mgr $ update "Hello World"

>>> statusesUpdate "Hello World"
APIRequest "POST" "https://api.twitter.com/1.1/statuses/update.json" [("status","Hello World")]
>>> statusesUpdate "Hello World" & #in_reply_to_status_id ?~ 1234567890
APIRequest "POST" "https://api.twitter.com/1.1/statuses/update.json" [("in_reply_to_status_id","1234567890"),("status","Hello World")]

type StatusesRetweetId = '["trim_user" := Bool, "tweet_mode" := TweetMode]

statusesRetweetId :: StatusId -> APIRequest StatusesRetweetId RetweetedStatus

Returns post data which retweets a tweet, specified by ID.

You can perform a search query using call:

res <- call twInfo mgr $ retweetId 1234567890

>>> statusesRetweetId 1234567890
APIRequest "POST" "https://api.twitter.com/1.1/statuses/retweet/1234567890.json" []

type StatusesUpdateWithMedia = '["possibly_sensitive" := Bool, "in_reply_to_status_id" := Integer, "display_coordinates" := Bool, "tweet_mode" := TweetMode]

statusesUpdateWithMedia :: Text -> MediaData -> APIRequest StatusesUpdateWithMedia Status

Returns post data which updates the authenticating user's current status and attaches media for upload.

You can perform a search query using call:

res <- call twInfo mgr $ updateWithMedia "Hello World" (MediaFromFile "homethimura/test.jpeg")

>>> statusesUpdateWithMedia "Hello World" (MediaFromFile "/home/fuga/test.jpeg")
APIRequestMultipart "POST" "https://api.twitter.com/1.1/statuses/update_with_media.json" [("status","Hello World")]

type StatusesLookup = '["include_entities" := Bool, "trim_user" := Bool, "map" := Bool, "tweet_mode" := TweetMode]

statusesLookup :: [StatusId] -> APIRequest StatusesLookup [Status]

Returns fully-hydrated tweet objects for up to 100 tweets per request, as specified by comma-separated values passed to the id parameter.

You can perform a request using call:

res <- call twInfo mgr $ lookup [20, 432656548536401920]

>>> statusesLookup [10]
APIRequest "GET" "https://api.twitter.com/1.1/statuses/lookup.json" [("id","10")]
>>> statusesLookup [10, 432656548536401920]
APIRequest "GET" "https://api.twitter.com/1.1/statuses/lookup.json" [("id","10,432656548536401920")]
>>> statusesLookup [10, 432656548536401920] & #include_entities ?~ True
APIRequest "GET" "https://api.twitter.com/1.1/statuses/lookup.json" [("include_entities","true"),("id","10,432656548536401920")]

Search

type SearchTweets = '["lang" := Text, "locale" := Text, "result_type" := Text, "count" := Integer, "until" := Day, "since_id" := Integer, "max_id" := Integer, "include_entities" := Bool, "tweet_mode" := TweetMode]

searchTweets

Arguments

:: Text

search string

-> APIRequest SearchTweets (SearchResult [Status])

Returns search query.

You can perform a search query using call:

res <- call (searchTweets "search text")
print $ res ^. searchResultStatuses

>>> searchTweets "search text"
APIRequest "GET" "https://api.twitter.com/1.1/search/tweets.json" [("q","search text")]
>>> searchTweets "search text" & #lang ?~ "ja" & #count ?~ 100
APIRequest "GET" "https://api.twitter.com/1.1/search/tweets.json" [("count","100"),("lang","ja"),("q","search text")]

search

Arguments

:: Text

search string

-> APIRequest SearchTweets (SearchResult [Status])

Deprecated: Please use Web.Twitter.Conduit.searchTweets

Alias of searchTweets, for backward compatibility

Direct Messages

type DirectMessages = '["count" := Integer, "include_entities" := Bool, "skip_status" := Bool, "full_text" := Bool, "cursor" := Text]

directMessages :: APIRequest DirectMessages (WithCursor Text EventsCursorKey DirectMessage)

Returns query data which asks recent direct messages sent to the authenticating user.

You can perform a query using call:

res <- call twInfo mgr $ directMessages & #count ?~ 50

>>> directMessages
APIRequest "GET" "https://api.twitter.com/1.1/direct_messages/events/list.json" []
>>> directMessages & #count ?~ 50
APIRequest "GET" "https://api.twitter.com/1.1/direct_messages/events/list.json" [("count","50")]

type DirectMessagesSent = '["since_id" := Integer, "max_id" := Integer, "count" := Integer, "include_entities" := Bool, "page" := Integer, "skip_status" := Bool, "full_text" := Bool]

directMessagesSent :: APIRequest DirectMessagesSent [DirectMessage]

Returns query data which asks recent direct messages sent by the authenticating user.

You can perform a query using call:

res <- call twInfo mgr $ directMessagesSent & #count ?~ 100

>>> directMessagesSent
APIRequest "GET" "https://api.twitter.com/1.1/direct_messages/sent.json" []
>>> directMessagesSent & #count ?~ 100
APIRequest "GET" "https://api.twitter.com/1.1/direct_messages/sent.json" [("count","100")]

type DirectMessagesShow = '["full_text" := Bool]

directMessagesShow :: StatusId -> APIRequest DirectMessagesShow DirectMessage

Returns query data which asks a single direct message, specified by an id parameter.

You can perform a query using call:

res <- call twInfo mgr $ directMessagesShow 1234567890

>>> directMessagesShow 1234567890
APIRequest "GET" "https://api.twitter.com/1.1/direct_messages/show.json" [("id","1234567890")]

type DirectMessagesDestroy = EmptyParams

directMessagesDestroy :: StatusId -> APIRequest DirectMessagesDestroy NoContent

Returns post data which destroys the direct message specified in the required ID parameter.

You can perform a query using call:

res <- call twInfo mgr $ directMessagesDestroy 1234567890

>>> directMessagesDestroy 1234567890
APIRequest "DELETE" "https://api.twitter.com/1.1/direct_messages/events/destroy.json" [("id","1234567890")]

type DirectMessagesNew = EmptyParams

directMessagesNew :: RecipientId -> Text -> APIRequest DirectMessagesNew DirectMessagesNewResponse

Returns post data which sends a new direct message to the specified user from the authenticating user.

You can perform a post using call:

res <- call twInfo mgr $ directMessagesNew (ScreenNameParam "thimura") "Hello DM"

>>> directMessagesNew 69179963 "Hello thimura! by UserId"
APIRequestJSON "POST" "https://api.twitter.com/1.1/direct_messages/events/new.json" []

Friends & Followers

type FriendshipsNoRetweetsIds = EmptyParams

friendshipsNoRetweetsIds :: APIRequest FriendshipsNoRetweetsIds [UserId]

Returns a collection of user_ids that the currently authenticated user does not want to receive retweets from.

You can perform a request using call:

res <- call twInfo mgr $ friendshipsNoRetweetsIds

>>> friendshipsNoRetweetsIds
APIRequest "GET" "https://api.twitter.com/1.1/friendships/no_retweets/ids.json" []

type FriendsIds = '["count" := Integer, "cursor" := Integer]

friendsIds :: UserParam -> APIRequest FriendsIds (WithCursor Integer IdsCursorKey UserId)

Returns query data which asks a collection of user IDs for every user the specified user is following.

You can perform a query using call:

res <- call twInfo mgr $ friendsIds (ScreenNameParam "thimura")

Or, you can iterate with sourceWithCursor:

sourceWithCursor (friendsIds (ScreenNameParam "thimura")) $$ CL.consume

>>> friendsIds (ScreenNameParam "thimura")
APIRequest "GET" "https://api.twitter.com/1.1/friends/ids.json" [("screen_name","thimura")]
>>> friendsIds (ScreenNameParam "thimura") & #count ?~ 5000
APIRequest "GET" "https://api.twitter.com/1.1/friends/ids.json" [("count","5000"),("screen_name","thimura")]

type FollowersIds = '["count" := Integer, "cursor" := Integer]

followersIds :: UserParam -> APIRequest FollowersIds (WithCursor Integer IdsCursorKey UserId)

Returns query data which asks a collection of user IDs for every user following the specified user.

You can perform a query using call:

res <- call twInfo mgr $ followersIds (ScreenNameParam "thimura")

Or, you can iterate with sourceWithCursor:

sourceWithCursor (followersIds (ScreenNameParam "thimura")) $$ CL.consume

>>> followersIds (ScreenNameParam "thimura")
APIRequest "GET" "https://api.twitter.com/1.1/followers/ids.json" [("screen_name","thimura")]
>>> followersIds (ScreenNameParam "thimura") & #count ?~ 5000
APIRequest "GET" "https://api.twitter.com/1.1/followers/ids.json" [("count","5000"),("screen_name","thimura")]

type FriendshipsIncoming = '["cursor" := Integer]

friendshipsIncoming :: APIRequest FriendshipsIncoming (WithCursor Integer IdsCursorKey UserId)

Returns a collection of numeric IDs for every user who has a pending request to follow the authenticating user.

You can perform a request by using call:

res <- call twInfo mgr $ friendshipsIncoming

Or, you can iterate with sourceWithCursor:

sourceWithCursor friendshipsIncoming $$ CL.consume

>>> friendshipsIncoming
APIRequest "GET" "https://api.twitter.com/1.1/friendships/incoming.json" []

type FriendshipsOutgoing = '["cursor" := Integer]

friendshipsOutgoing :: APIRequest FriendshipsOutgoing (WithCursor Integer IdsCursorKey UserId)

Returns a collection of numeric IDs for every protected user for whom the authenticating user has a pending follow request.

You can perform a request by using call:

res <- call twInfo mgr $ friendshipsOutgoing

Or, you can iterate with sourceWithCursor:

sourceWithCursor friendshipsOutgoing $$ CL.consume

>>> friendshipsOutgoing
APIRequest "GET" "https://api.twitter.com/1.1/friendships/outgoing.json" []

type FriendshipsCreate = '["follow" := Bool]

friendshipsCreate :: UserParam -> APIRequest FriendshipsCreate User

Returns post data which follows the user specified in the ID parameter.

You can perform request by using call:

res <- call twInfo mgr $ friendshipsCreate (ScreenNameParam "thimura")

>>> friendshipsCreate (ScreenNameParam "thimura")
APIRequest "POST" "https://api.twitter.com/1.1/friendships/create.json" [("screen_name","thimura")]
>>> friendshipsCreate (UserIdParam 69179963)
APIRequest "POST" "https://api.twitter.com/1.1/friendships/create.json" [("user_id","69179963")]

type FriendshipsDestroy = EmptyParams

friendshipsDestroy :: UserParam -> APIRequest FriendshipsDestroy User

Returns post data which unfollows the user specified in the ID parameter.

You can perform request by using call:

res <- call twInfo mgr $ friendshipsDestroy (ScreenNameParam "thimura")

>>> friendshipsDestroy (ScreenNameParam "thimura")
APIRequest "POST" "https://api.twitter.com/1.1/friendships/destroy.json" [("screen_name","thimura")]
>>> friendshipsDestroy (UserIdParam 69179963)
APIRequest "POST" "https://api.twitter.com/1.1/friendships/destroy.json" [("user_id","69179963")]

type FriendsList = '["count" := Integer, "cursor" := Integer, "skip_status" := Bool, "include_user_entities" := Bool]

friendsList :: UserParam -> APIRequest FriendsList (WithCursor Integer UsersCursorKey User)

Returns query data which asks a cursored collection of user objects for every user the specified users is following.

You can perform request by using call:

res <- call twInfo mgr $ friendsList (ScreenNameParam "thimura")

Or, you can iterate with sourceWithCursor:

sourceWithCursor (friendsList (ScreenNameParam "thimura")) $$ CL.consume

>>> friendsList (ScreenNameParam "thimura")
APIRequest "GET" "https://api.twitter.com/1.1/friends/list.json" [("screen_name","thimura")]
>>> friendsList (UserIdParam 69179963)
APIRequest "GET" "https://api.twitter.com/1.1/friends/list.json" [("user_id","69179963")]

type FollowersList = '["count" := Integer, "cursor" := Integer, "skip_status" := Bool, "include_user_entities" := Bool]

followersList :: UserParam -> APIRequest FollowersList (WithCursor Integer UsersCursorKey User)

Returns query data which asks a cursored collection of user objects for users following the specified user.

You can perform request by using call:

res <- call twInfo mgr $ followersList (ScreenNameParam "thimura")

Or, you can iterate with sourceWithCursor:

sourceWithCursor (followersList (ScreenNameParam "thimura")) $$ CL.consume

>>> followersList (ScreenNameParam "thimura")
APIRequest "GET" "https://api.twitter.com/1.1/followers/list.json" [("screen_name","thimura")]
>>> followersList (UserIdParam 69179963)
APIRequest "GET" "https://api.twitter.com/1.1/followers/list.json" [("user_id","69179963")]

Users

type AccountVerifyCredentials = '["include_entities" := Bool, "skip_status" := Bool, "include_email" := Bool]

accountVerifyCredentials :: APIRequest AccountVerifyCredentials User

Returns query data asks that the credential is valid.

You can perform request by using call:

res <- call twInfo mgr $ accountVerifyCredentials

>>> accountVerifyCredentials
APIRequest "GET" "https://api.twitter.com/1.1/account/verify_credentials.json" []

type AccountUpdateProfile = '["include_entities" := Bool, "skip_status" := Bool, "name" := Text, "url" := URIString, "location" := Text, "description" := Text, "profile_link_color" := Text]

accountUpdateProfile :: APIRequest AccountUpdateProfile User

Returns user object with updated fields. Note that while no specific parameter is required, you need to provide at least one parameter before executing the query.

You can perform request by using call:

res <- call twInfo mgr $ accountUpdateProfile & #url ?~ "http://www.example.com"

>>> accountUpdateProfile & #url ?~ "http://www.example.com"
APIRequest "POST" "https://api.twitter.com/1.1/account/update_profile.json" [("url","http://www.example.com")]

type UsersLookup = '["include_entities" := Bool]

usersLookup :: UserListParam -> APIRequest UsersLookup [User]

Returns query data asks user objects.

You can perform request by using call:

res <- call twInfo mgr $ usersLookup (ScreenNameListParam ["thimura", "twitterapi"])

>>> usersLookup (ScreenNameListParam ["thimura", "twitterapi"])
APIRequest "GET" "https://api.twitter.com/1.1/users/lookup.json" [("screen_name","thimura,twitterapi")]

type UsersShow = '["include_entities" := Bool]

usersShow :: UserParam -> APIRequest UsersShow User

Returns query data asks the user specified by user id or screen name parameter.

You can perform request by using call:

res <- call twInfo mgr $ usersShow (ScreenNameParam "thimura")

>>> usersShow (ScreenNameParam "thimura")
APIRequest "GET" "https://api.twitter.com/1.1/users/show.json" [("screen_name","thimura")]

Suggested Users

Favorites

type FavoritesList = '["count" := Integer, "since_id" := Integer, "max_id" := Integer, "include_entities" := Bool, "tweet_mode" := TweetMode]

favoritesList :: Maybe UserParam -> APIRequest FavoritesList [Status]

Returns the 20 most recent Tweets favorited by the specified user.

You can perform request by using call:

res <- call twInfo mgr $ favoritesList (ScreenNameParam "thimura")

>>> favoritesList Nothing
APIRequest "GET" "https://api.twitter.com/1.1/favorites/list.json" []
>>> favoritesList (Just (ScreenNameParam "thimura"))
APIRequest "GET" "https://api.twitter.com/1.1/favorites/list.json" [("screen_name","thimura")]
>>> favoritesList (Just (UserIdParam 69179963))
APIRequest "GET" "https://api.twitter.com/1.1/favorites/list.json" [("user_id","69179963")]

type FavoritesDestroy = '["include_entities" := Bool, "tweet_mode" := TweetMode]

favoritesDestroy :: StatusId -> APIRequest FavoritesDestroy Status

Returns post data unfavorites the status specified in the ID parameter as the authenticating user.

You can perform request by using call:

res <- call twInfo mgr $ favoritesDestroy 1234567890

>>> favoritesDestroy 1234567890
APIRequest "POST" "https://api.twitter.com/1.1/favorites/destroy.json" [("id","1234567890")]

type FavoritesCreate = '["include_entities" := Bool, "tweet_mode" := TweetMode]

favoritesCreate :: StatusId -> APIRequest FavoritesCreate Status

Returns post data which favorites the status specified in the ID parameter as the authenticating user.

You can perform request by using call:

res <- call twInfo mgr $ favoritesCreate 1234567890

>>> favoritesCreate 1234567890
APIRequest "POST" "https://api.twitter.com/1.1/favorites/create.json" [("id","1234567890")]

Lists

type ListsStatuses = '["since_id" := Integer, "max_id" := Integer, "count" := Integer, "include_entities" := Bool, "include_rts" := Bool, "tweet_mode" := TweetMode]

listsStatuses :: ListParam -> APIRequest ListsStatuses [Status]

Returns the query parameter which fetches a timeline of tweets authored by members of the specified list.

You can perform request by using call:

res <- call twInfo mgr $ listsStatuses (ListNameParam "thimura/haskell")

If you need more statuses, you can obtain those by using sourceWithMaxId: res <- sourceWithMaxId (listsStatuses (ListNameParam "thimura/haskell") & #count ?~ 200) $$ CL.take 1000

>>> listsStatuses (ListNameParam "thimura/haskell")
APIRequest "GET" "https://api.twitter.com/1.1/lists/statuses.json" [("slug","haskell"),("owner_screen_name","thimura")]
>>> listsStatuses (ListIdParam 20849097)
APIRequest "GET" "https://api.twitter.com/1.1/lists/statuses.json" [("list_id","20849097")]

type ListsMembersDestroy = EmptyParams

listsMembersDestroy :: ListParam -> UserParam -> APIRequest ListsMembersDestroy List

Returns the post parameter which removes the specified member from the list.

You can perform request by using call:

res <- call twInfo mgr $ listsMembersDestroy (ListNameParam "thimura/haskell") (ScreenNameParam "thimura")

>>> listsMembersDestroy (ListNameParam "thimura/haskell") (ScreenNameParam "thimura")
APIRequest "POST" "https://api.twitter.com/1.1/lists/members/destroy.json" [("slug","haskell"),("owner_screen_name","thimura"),("screen_name","thimura")]
>>> listsMembersDestroy (ListIdParam 20849097) (UserIdParam 69179963)
APIRequest "POST" "https://api.twitter.com/1.1/lists/members/destroy.json" [("list_id","20849097"),("user_id","69179963")]

type ListsMemberships = '["count" := Integer, "cursor" := Integer]

listsMemberships :: Maybe UserParam -> APIRequest ListsMemberships (WithCursor Integer ListsCursorKey List)

Returns the request parameters which asks the lists the specified user has been added to. If UserParam are not provided, the memberships for the authenticating user are returned.

You can perform request by using call:

res <- call twInfo mgr $ listsMemberships (ListNameParam "thimura/haskell")

>>> listsMemberships Nothing
APIRequest "GET" "https://api.twitter.com/1.1/lists/memberships.json" []
>>> listsMemberships (Just (ScreenNameParam "thimura"))
APIRequest "GET" "https://api.twitter.com/1.1/lists/memberships.json" [("screen_name","thimura")]
>>> listsMemberships (Just (UserIdParam 69179963))
APIRequest "GET" "https://api.twitter.com/1.1/lists/memberships.json" [("user_id","69179963")]

type ListsSubscribers = '["count" := Integer, "cursor" := Integer, "skip_status" := Bool]

listsSubscribers :: ListParam -> APIRequest ListsSubscribers (WithCursor Integer UsersCursorKey User)

Returns the request parameter which asks the subscribers of the specified list.

You can perform request by using call:

res <- call twInfo mgr $ listsSubscribers (ListNameParam "thimura/haskell")

>>> listsSubscribers (ListNameParam "thimura/haskell")
APIRequest "GET" "https://api.twitter.com/1.1/lists/subscribers.json" [("slug","haskell"),("owner_screen_name","thimura")]
>>> listsSubscribers (ListIdParam 20849097)
APIRequest "GET" "https://api.twitter.com/1.1/lists/subscribers.json" [("list_id","20849097")]

type ListsMembersCreateAll = EmptyParams

listsMembersCreateAll :: ListParam -> UserListParam -> APIRequest ListsMembersCreateAll List

Adds multiple members to a list.

You can perform request by using call:

res <- call twInfo mgr $ listsMembersCreateAll (ListNameParam "thimura/haskell") (ScreenNameListParam ["thimura", "twitterapi"])

>>> listsMembersCreateAll (ListNameParam "thimura/haskell") (ScreenNameListParam ["thimura", "twitterapi"])
APIRequest "POST" "https://api.twitter.com/1.1/lists/members/create_all.json" [("slug","haskell"),("owner_screen_name","thimura"),("screen_name","thimura,twitterapi")]
>>> listsMembersCreateAll (ListIdParam 20849097) (UserIdListParam [69179963, 6253282])
APIRequest "POST" "https://api.twitter.com/1.1/lists/members/create_all.json" [("list_id","20849097"),("user_id","69179963,6253282")]

type ListsMembers = '["count" := Integer, "cursor" := Integer, "skip_status" := Bool]

listsMembers :: ListParam -> APIRequest ListsMembers (WithCursor Integer UsersCursorKey User)

Returns query data asks the members of the specified list.

You can perform request by using call:

res <- call twInfo mgr $ listsMembers (ListNameParam "thimura/haskell")

>>> listsMembers (ListNameParam "thimura/haskell")
APIRequest "GET" "https://api.twitter.com/1.1/lists/members.json" [("slug","haskell"),("owner_screen_name","thimura")]
>>> listsMembers (ListIdParam 20849097)
APIRequest "GET" "https://api.twitter.com/1.1/lists/members.json" [("list_id","20849097")]

type ListsMembersCreate = EmptyParams

listsMembersCreate :: ListParam -> UserParam -> APIRequest ListsMembersCreate List

Returns the post parameter which adds a member to a list.

You can perform request by using call:

res <- call twInfo mgr $ listsMembersCreate (ListNameParam "thimura/haskell") (ScreenNameParam "thimura")

>>> listsMembersCreate (ListNameParam "thimura/haskell") (ScreenNameParam "thimura")
APIRequest "POST" "https://api.twitter.com/1.1/lists/members/create.json" [("slug","haskell"),("owner_screen_name","thimura"),("screen_name","thimura")]
>>> listsMembersCreate (ListIdParam 20849097) (UserIdParam 69179963)
APIRequest "POST" "https://api.twitter.com/1.1/lists/members/create.json" [("list_id","20849097"),("user_id","69179963")]

type ListsDestroy = EmptyParams

listsDestroy :: ListParam -> APIRequest ListsDestroy List

Returns the post parameter which deletes the specified list.

You can perform request by using call:

res <- call twInfo mgr $ listsDestroy (ListNameParam "thimura/haskell")

>>> listsDestroy (ListNameParam "thimura/haskell")
APIRequest "POST" "https://api.twitter.com/1.1/lists/destroy.json" [("slug","haskell"),("owner_screen_name","thimura")]
>>> listsDestroy (ListIdParam 20849097)
APIRequest "POST" "https://api.twitter.com/1.1/lists/destroy.json" [("list_id","20849097")]

type ListsUpdate = EmptyParams

listsUpdate

Arguments

:: ListParam

-> Bool

is public

-> Maybe Text

description

-> APIRequest ListsUpdate List

Returns the post parameter which updates the specified list.

You can perform request by using call:

res <- call twInfo mgr $ listsUpdate (ListNameParam "thimura/haskell") True (Just Haskellers)

>>> listsUpdate (ListNameParam "thimura/haskell") True (Just "Haskellers")
APIRequest "POST" "https://api.twitter.com/1.1/lists/update.json" [("slug","haskell"),("owner_screen_name","thimura"),("description","Haskellers"),("mode","public")]

type ListsCreate = EmptyParams

listsCreate

Arguments

:: Text

list name

-> Bool

whether public(True) or private(False)

-> Maybe Text

the description to give the list

-> APIRequest ListsCreate List

Returns the post parameter which creates a new list for the authenticated user.

You can perform request by using call:

res <- call twInfo mgr $ listsCreate (ListNameParam "thimura/haskell")

>>> listsCreate "haskell" True Nothing
APIRequest "POST" "https://api.twitter.com/1.1/lists/create.json" [("name","haskell"),("mode","public")]
>>> listsCreate "haskell" False Nothing
APIRequest "POST" "https://api.twitter.com/1.1/lists/create.json" [("name","haskell"),("mode","private")]
>>> listsCreate "haskell" True (Just "Haskellers")
APIRequest "POST" "https://api.twitter.com/1.1/lists/create.json" [("description","Haskellers"),("name","haskell"),("mode","public")]

type ListsShow = EmptyParams

listsShow :: ListParam -> APIRequest ListsShow List

Returns the request parameter which asks the specified list.

You can perform request by using call:

res <- call twInfo mgr $ listsShow (ListNameParam "thimura/haskell")

>>> listsShow (ListNameParam "thimura/haskell")
APIRequest "GET" "https://api.twitter.com/1.1/lists/show.json" [("slug","haskell"),("owner_screen_name","thimura")]
>>> listsShow (ListIdParam 20849097)
APIRequest "GET" "https://api.twitter.com/1.1/lists/show.json" [("list_id","20849097")]

type ListsSubscriptions = '["count" := Integer, "cursor" := Integer]

listsSubscriptions :: Maybe UserParam -> APIRequest ListsSubscriptions (WithCursor Integer ListsCursorKey List)

Returns the request parameter which obtains a collection of the lists the specified user is subscribed to.

You can perform request by using call:

res <- call twInfo mgr $ listsSubscriptions (ListNameParam "thimura/haskell")

>>> listsSubscriptions Nothing
APIRequest "GET" "https://api.twitter.com/1.1/lists/subscriptions.json" []
>>> listsSubscriptions (Just (ScreenNameParam "thimura"))
APIRequest "GET" "https://api.twitter.com/1.1/lists/subscriptions.json" [("screen_name","thimura")]
>>> listsSubscriptions (Just (UserIdParam 69179963))
APIRequest "GET" "https://api.twitter.com/1.1/lists/subscriptions.json" [("user_id","69179963")]

type ListsMembersDestroyAll = EmptyParams

listsMembersDestroyAll :: ListParam -> UserListParam -> APIRequest ListsMembersDestroyAll List

Adds multiple members to a list.

You can perform request by using call:

res <- call twInfo mgr $ listsMembersDestroyAll (ListNameParam "thimura/haskell") (ScreenNameListParam ["thimura", "twitterapi"])

>>> listsMembersDestroyAll (ListNameParam "thimura/haskell") (ScreenNameListParam ["thimura", "twitterapi"])
APIRequest "POST" "https://api.twitter.com/1.1/lists/members/destroy_all.json" [("slug","haskell"),("owner_screen_name","thimura"),("screen_name","thimura,twitterapi")]
>>> listsMembersDestroyAll (ListIdParam 20849097) (UserIdListParam [69179963, 6253282])
APIRequest "POST" "https://api.twitter.com/1.1/lists/members/destroy_all.json" [("list_id","20849097"),("user_id","69179963,6253282")]

type ListsOwnerships = '["count" := Integer, "cursor" := Integer]

listsOwnerships :: Maybe UserParam -> APIRequest ListsOwnerships (WithCursor Integer ListsCursorKey List)

Returns the request parameter which asks the lists owned by the specified Twitter user.

You can perform request by using call:

res <- call twInfo mgr $ listsOwnerships (ListNameParam "thimura/haskell")

>>> listsOwnerships Nothing
APIRequest "GET" "https://api.twitter.com/1.1/lists/ownerships.json" []
>>> listsOwnerships (Just (ScreenNameParam "thimura"))
APIRequest "GET" "https://api.twitter.com/1.1/lists/ownerships.json" [("screen_name","thimura")]
>>> listsOwnerships (Just (UserIdParam 69179963))
APIRequest "GET" "https://api.twitter.com/1.1/lists/ownerships.json" [("user_id","69179963")]

Saved Searches

Places & Geo

media

type MediaUpload = EmptyParams

mediaUpload :: MediaData -> APIRequest MediaUpload UploadedMedia

Upload media and returns the media data.

You can update your status with multiple media by calling mediaUpload and update successively.

First, you should upload media with mediaUpload:

res1 <- call twInfo mgr $ mediaUpload (MediaFromFile "/path/to/upload/file1.png")
res2 <- call twInfo mgr $ mediaUpload (MediaRequestBody "file2.png" "[.. file body ..]")

and then collect the resulting media IDs and update your status by calling update:

call twInfo mgr $ update "Hello World" & #media_ids ?~ [uploadedMediaId res1, uploadedMediaId res2]

See: https://dev.twitter.com/docs/api/multiple-media-extended-entities

>>> mediaUpload (MediaFromFile "/home/test/test.png")
APIRequestMultipart "POST" "https://upload.twitter.com/1.1/media/upload.json" []