add to docs for search_tweets and get_timeline

R/search_tweets.R

@@ -21,6 +21,20 @@
 #'   e.g., \code{q = '"data science"'} or escape each internal double
 #'   quote with a single backslash, e.g., \code{q =
 #'   "\"data science\""}.
+#'
+#' Some other useful query tips:
+#'
+#' \itemize{
+#'   \item Exclude retweets via \code{"-filter:retweets"}
+#'   \item Exclude quotes via \code{"-filter:quote"}
+#'   \item Exclude replies via \code{"-filter:replies"}
+#'   \item Filter (return only) verified via \code{"filter:verified"}
+#'   \item Exclude verified via \code{"-filter:verified"}
+#'   \item Get everything (firehose for free) via \code{"-filter:verified OR filter:verified"}
+#'   \item Filter (return only) tweets with links to news articles via \code{"filter:news"}
+#'   \item Filter (return only) tweets with media \code{"filter:media"}
+#' }
+#'
 #' @param n Integer, specifying the total number of desired tweets to
 #'   return. Defaults to 100. Maximum number of tweets returned from a
 #'   single token is 18,000. To return more than 18,000 tweets, users

R/timeline.R

@@ -5,7 +5,9 @@
 #'
 #' @param user Vector of user names, user IDs, or a mixture of both.
 #' @param n Number of tweets to return per timeline. Defaults to 100.
-#'   Must be of length 1 or equal to length of user.
+#'   Must be of length 1 or equal to length of user. This number should
+#'   not exceed 3200 as Twitter limits returns to the most recent 3,200
+#'   statuses posted or retweeted by each user.
 #' @param max_id Character, returns results with an ID less than (that is,
 #'   older than) or equal to `max_id`.
 #' @param home Logical, indicating whether to return a user-timeline