Get Historical Tweets with Hashtags Iteratively

Obsoleta: preferí getTweetsSearchAPI(), basada en la API de X (datos del JSON, mas robusta).

Esta función realiza búsquedas históricas de tweets con hashtags específicos de forma iterativa, permitiendo recolectar tweets en intervalos de tiempo específicos (días, horas o minutos).

Usage

getTweetsHistoricalHashtagFor(
  iterations,
  hashtag,
  n_tweets,
  since,
  until,
  interval_unit = "days",
  xuser = Sys.getenv("TWITTER_USER", Sys.getenv("USER")),
  xpass = Sys.getenv("TWITTER_PASS", Sys.getenv("PASS")),
  dir = getwd(),
  system = "windows",
  kill_system = FALSE,
  sleep_time = 5 * 60
)

Arguments

iterations

Número de iteraciones a realizar.

hashtag

Hashtag específico para buscar en los tweets.

n_tweets

Número de tweets a recolectar por iteración.

since

Fecha y hora de inicio para la búsqueda (formato: "YYYY-MM-DD_HH:MM:SS_UTC").

until

Número de unidades de tiempo a avanzar en cada iteración.

interval_unit

Unidad de tiempo para el intervalo ("days", "hours", o "minutes").

xuser

Nombre de usuario de Twitter para autenticación (por defecto: variable de entorno TWITTER_USER o, en su defecto, USER).

xpass

Contraseña de Twitter para autenticación (por defecto: variable de entorno TWITTER_PASS o, en su defecto, PASS).

dir

Directorio para guardar los tweets recolectados (por defecto: directorio de trabajo actual).

system

Sistema operativo ("windows", "unix", o "mac"). Se mantiene por compatibilidad; el cierre del navegador ya no depende del sistema operativo.

kill_system

Booleano que indica si se debe cerrar el navegador (solo las sesiones propias del paquete) después de cada iteración (por defecto: FALSE).

sleep_time

Tiempo de espera entre iteraciones en segundos (por defecto: 300 segundos).

Value

No devuelve un valor explícito, pero guarda los tweets recolectados en el directorio especificado.

Details

La función realiza las siguientes operaciones:

1. Valida el formato de la fecha y hora de inicio.

2. Crea el directorio de destino si no existe.

3. Ejecuta búsquedas históricas de tweets con el hashtag especificado de forma iterativa.

4. Calcula la fecha y hora de finalización para cada iteración basándose en el intervalo especificado.

5. Cierra el navegador después de cada iteración si kill_system es TRUE.

6. Espera un tiempo especificado entre iteraciones.

Examples

if (FALSE) { # \dontrun{
getTweetsHistoricalHashtagFor(
  iterations = 5,
  hashtag = "#8M",
  n_tweets = 500,
  since = "2023-03-01_00:00:00_UTC",
  until = 3,
  interval_unit = "days",
  dir = "./datos/tweets",
  system = "windows",
  kill_system = FALSE,
  sleep_time = 300
)

# Usando intervalos de horas
getTweetsHistoricalHashtagFor(
  iterations = 12,
  hashtag = "#8M",
  n_tweets = 500,
  since = "2023-03-01_00:00:00_UTC",
  until = 2,
  interval_unit = "hours",
  dir = "./datos/tweets",
  system = "windows",
  kill_system = FALSE,
  sleep_time = 300
)
} # }