1\name{getUser}
2\alias{getUser}
3\alias{lookupUsers}
4\title{ Functions to manage Twitter users }
5\description{
6  These functions allow you interact with information about a Twitter
7  user - retrieving their base information, list of friends, list of
8  followers, and an up to date timeline.
9}
10\usage{
11getUser(user, ...)
12lookupUsers(users, includeNA=FALSE, ...)
13}
14\arguments{
15  \item{user}{ The Twitter user to detail, can be \code{character} or
16    an \code{\link{user}} object.}
17  \item{users}{A vector of either user IDs or screen names or a mix of both}
18  \item{includeNA}{If \code{TRUE} will leave an NA element in the return list for users that don't exist}
19  \item{...}{Optional arguments to be passed to \code{\link{GET}}}
20}
21\details{
22  These functions will only return fully formed objects if the
23  authenticated user is allowed to see the requested user.  If that
24  person has a private account and has not allowed you to see them, you
25  will not be able to extract that information.
26
27  The \code{lookupUsers} function should be used in cases where there are
28  multiple lookups going to take place, to reduce the API call load.  This function
29  requires OAuth authentication.
30}
31\value{
32  The \code{getUser} function returns an object of class
33  \code{\link{user}}.
34
35  The \code{lookupUsers} function will return a list of \code{\link{user}} objects,
36  sorted in the order of the \code{users} argument, with names being the particular
37  element of \code{users} that it matches to. If the \code{includeNA} argument is set
38  to \code{FALSE} (default), any non-existing users will be dropped from the list.
39}
40\author{Jeff Gentry}
41\seealso{\code{\link{mentions}}}
42\examples{
43      \dontrun{
44        tuser <- getUser('geoffjentry')
45        users <- lookupUsers(c('geoffjentry', 'whitehouse'))
46      }
47}
48\keyword{ interface }
49