iatv_top_trending: Top Trending Topics (Internet Archive TV Archive)

In hrbrmstr/newsflash: Tools to Work with the Internet Archive and GDELT Television Explorer

Top Trending Topics (Internet Archive TV Archive)

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

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

Arguments

from, to	start and end date/time ranges (will auto-convert if properly formatted strings)
.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).

Note

The times are auto-converted to GMT

Examples

top_trending("2017-09-08 18:00", "2017-09-09 06:00")

hrbrmstr/newsflash documentation built on Dec. 4, 2022, 1:35 p.m.