smappR (version 0.5)

searchTweets: Search recent tweets

Description

searchTweets connects to the REST API of Twitter and returns recent tweets (usually no more than 5-7 days old) based on a supplied search string. Note that this function will not return all tweets. As explained in the documentation (https://dev.twitter.com/rest/public/search), the goal of this API endpoint is relevance and not completeness.

Usage

searchTweets(q, filename, n = 200, oauth_folder = "~/credentials", until = NULL, since_id = NULL, result_type = "recent", lang = NULL, sleep = 0.5, verbose = FALSE)

Arguments

q

search query to issue to Twitter. It can contain Boolean operators.

filename

file where tweets will be stored (in json format)

n

maximum number of tweets to be downloaded

oauth_folder

folder where OAuth tokens are stored.

until

limit for the most recent tweet. The function will then returns tweets created before this date. Date should be formatted as YYYY-MM-DD. Keep in mind that the search index has a 7-day limit

since_id

id of the oldest tweet to be downloaded. Useful if, for example, we're only interested in getting tweets sent after a certain date.

result_type

specifies the type of results you would prefer to receive: "recent" (default), "popular" or "mixed".

lang

restricts tweets to the given language (e.g. "es")

sleep

numeric, number of seconds between API calls. Higher number will increase reliability of API calls; lower number will increase speed.

verbose

If TRUE, provides additional output in console about API rate limits

Examples

## Not run: 
# ## Download recent tweets by user "p_barbera"
#  searchTweets(q="twitter", filename="twitter-tweets.json",
#    n=200, oauth_folder="oauth")
# ## End(Not run)