searchTweets: Search recent tweets

Description Usage Arguments Author(s) Examples

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

1
2
3
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

Author(s)

Pablo Barbera pbarbera@usc.edu

Examples

1
2
3
4
5
6
## Not run: 
## Download recent tweets by user "p_barbera"
 searchTweets(q="twitter", filename="twitter-tweets.json", 
   n=200, oauth_folder="oauth")

## End(Not run)

NetDem-USC/netdemR documentation built on May 7, 2019, 6:06 p.m.