R: Search fullarchive (PREMIUM)

search_fullarchive {rtweet} | R Documentation

## Search fullarchive (PREMIUM)

### Description

Search Twitter's 'fullarchive' (PREMIUM) API

### Usage

    search_fullarchive(
      q,
      n = 100,
      fromDate = NULL,
      toDate = NULL,
      env_name = NULL,
      safedir = NULL,
      parse = TRUE,
      token = NULL
    )

### Arguments

`q` | Search query on which to match/filter tweets. See details for information about available search operators.
`n` | Number of tweets to return; it is best to set this number in intervals of 100 for the '30day' API and either 100 (for sandbox) or 500 (for paid) for the 'fullarchive' API. Default is 100.
`fromDate` | Oldest date-time (YYYYMMDDHHMM) from which tweets should be searched for.
`toDate` | Newest date-time (YYYYMMDDHHMM) from which tweets should be searched for.
`env_name` | Name/label of developer environment to use for the search.
`safedir` | Name of directory to which each response object should be saved. If the directory doesn't exist, it will be created. If NULL (the default) then a dir will be created in the current working directory. To override/deactivate safedir set this to FALSE.
`parse` | Logical indicating whether to convert data into data frame.
`token` | A token associated with a user-created APP (requires a developer account), which is converted to a bearer token in order to make premium API requests

### Value

A tibble data frame of Twitter data

### Developer Account

Users must have an approved developer account and an active/labeled environment to access Twitter's premium APIs. For more information, to check your current Subscriptions and Dev Environments, or to apply for a developer account visit https://developer.twitter.com.

### Search operators

Note: Bolded operators ending with a colon should be immediately followed by a word or quoted phrase (if appropriate)–e.g., `lang:en`

### Keyword

- "" ~~ match exact phrase

- # ~~ hashtag

- @ ~~ at mentions)

- url: ~~ found in URL

- lang: ~~ language of tweet

### Accounts of interest

- from: ~~ authored by

- to: ~~ sent to

- retweets_of: ~~ retweet author

### Tweet attributes

- is:retweet ~~ only retweets

- has:mentions ~~ uses mention(s)

- has:hashtags ~~ uses hashtags(s)

- has:media ~~ includes media(s)

- has:videos ~~ includes video(s)

- has:images ~~ includes image(s)

- has:links ~~ includes URL(s)

- is:verified ~~ from verified accounts

### Geospatial

- bounding_box:[west_long south_lat east_long north_lat] ~~ lat/long coordinates box

- point_radius:[lon lat radius] ~~ center of search radius

- has:geo ~~ uses geotagging

- place: ~~ by place

- place_country: ~~ by country

- has:profile_geo ~~ geo associated with profile

- profile_country: ~~ country associated with profile

- profile_region: ~~ region associated with profile

- profile_locality: ~~ locality associated with profile

### Examples

    ## Not run:
    ## search fullarchive for up to 300 rstats tweets sent in Jan 2014
    rt <- search_fullarchive("#rstats", n = 300, env_name = "research",
      fromDate = "201401010000", toDate = "201401312359")

    ## End(Not run)

[Package rtweet version 0.7.0 Index]