newsflash (version 0.6.0)

top_trending_range: Top Trending Tables (Ranged)

Description

Provide start & end times in current time zone and this function will generate the proper "every 15-second" values, convert them to GMT values and issue the queries, returning a nested data frame of results. If you want more control, use top_trending().

Usage

top_trending_range(from, to, .progress = interactive())

Arguments

from, to

start and end POSIXct values in current time zone.

.progress

show a progress bar? Defaukts to TRUE if in an interactive session.

Details

GDELT now generates a snapshot every 15 minutes that records all of the "top trending" tables into a single archive enabling users to ook back over time at what was trending in 15 minute increments historically back to midnight on 2017-09-07.

Note that the archives are generated every 15 minutes based on the television shows that have completed processing at that time. It can take several hours for a show to be fully processed by the Internet Archive and available for processing, thus the presence/absence of a topic in these files should not be used to date it precisely to that 15 minute mark, but rather as a rough temporal indicator of what topics were trending up/down in that general time frame. For precise timelines, you should take a topic from this archive and run a search on it using the main Television Explorer interface, select a timeframe of 72 hours and use the resulting timeline to precisely date the topic's coverage (since the Explorer timeline is based on the broadcast timestamp of the show, even if it is processed hours later).

Examples

# NOT RUN {
# This gets the from/to times in current time zone
from <- as.POSIXct("2017-09-08 18:00:00")
to <- as.POSIXct("2017-09-09 06:00:00")

top_trending_range(from, to)
# }