govtube_search_instances
Search spoken instances
Find spoken instances of words or a phrase across official videos and White House transcripts.
Returns one small page: counts for the whole result, then up to 5 videos (newest first, or most instances
first with sort="most_instances"), each with up to 3 passages (quotes; overlapping instances merged), each
passage listing its instances with citation id and share_url. `notes` and `more_passages` say what else
there is: use `next_cursor` for more videos, govtube_list_video_instances for the rest of one video, and
detail="full" for larger pages. White House transcripts have no timing (`timing_granularity` "document",
null times, a `position` and a `document_url`).
Parameterssortqueryrequiredcursordetailsourcedate_tospeakerdate_frommax_videosplayable_onlyinclude_unreviewedmax_instances_per_video
govtube_list_video_instances
List instances in one video
Page through one video's matches by passage, in time order.
A passage is a run of instances whose excerpts overlap, shown as one quote. `offset` and `limit` count
passages; `next_offset` is null on the last page. `passage_count` and `instance_count` cover the whole
video. With detail="full", `instances` also lists every instance of the page one by one.
Parameterslimitqueryrequireddetailoffsetspeakervideo_idrequiredinclude_unreviewed
govtube_get_transcript_window
Read transcript around a moment
Return speaker turns overlapping [start_ms, end_ms] with their text, for checking context.
A turn with cluster null and speaker "No speaker label" holds words no voice was found for. The words are as
heard; don't attribute them to a neighbouring speaker.
Not available for official transcripts without timing (timing_granularity "document"): read those at the
result's document_url, or resolve the citation for the surrounding turns.
Parametersend_msrequiredstart_msrequiredvideo_idrequired
govtube_get_video
Video details, provenance and rights
Metadata, speakers, playback asset and the rights and use restrictions of the video's source.
Parametersvideo_idrequired
govtube_resolve_citation
Resolve a citation id
Check that a cited instance still says the quoted words after corrections, and return its context.
The result has a share_url to link. gd2./gd1. ids cite words in an official transcript: the result has
positions instead of times, citation_text to paste, document_highlight_url, and `certifies` saying what is
(and is not) certified.
Parameterscitation_idrequired
govtube_get_coverage
What the index covers
Totals for the whole index, video and official transcripts counted apart: video sessions, hours and
words transcribed; official transcripts (text, no timing); each source; date ranges, last update, items
awaiting review and known gaps. Cite this with any count. For the list of sessions use
govtube_list_sessions.
Takes no parameters.
govtube_list_sessions
List indexed sessions
Every indexed item, one page at a time: video sessions and official transcripts (White House transcripts,
Congressional Record speeches, one item per speech). Newest first; on the same day, video sessions before
official transcripts. Each has title, date, source, length, words, whether it plays, and how many speakers
are confirmed. `total` matches govtube_get_coverage's counts for the same source.
Parameterskindlimitcursorsourcedate_todate_from
