gdelt_tv_search
Search US TV news coverage using transcripts, captions, OCR, and visual labels. Specify station and time window to retrieve matching clips.
Instructions
Search US television news coverage (transcripts, captions, OCR, visual labels). Search GDELT's Television 2.0 AI index of US television news.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | End of an absolute time window. Same formats as from. | |
| from | No | Start of an absolute time window. Accepts YYYY-MM-DD, RFC3339, or GDELT's raw YYYYMMDDHHMMSS. Cannot be combined with timespan. | |
| show | No | Limit to an exact show name. | |
| sort | No | Result order. | |
| visual | No | Search visual object/activity labels from computer vision (GDELT's visual: operator). Repeatable; multiple values are OR'd together. | |
| caption | No | Search human-provided closed captioning (GDELT's cap: operator). Repeatable; multiple values are OR'd together. | |
| concept | No | Search Google Knowledge Graph concepts extracted from captioning, by MID code (GDELT's capnlp: operator). Repeatable; multiple values are OR'd together. | |
| station | Yes | Station to search. | |
| timespan | No | Relative time window ending now, e.g. 1h, 7d, 3m, 1y. Cannot be combined with from/to. GDELT's TV archive starts July 6, 2010. | |
| maxrecords | No | Rows to return. GDELT's own hard cap is 3000 for this endpoint; there is no pagination cursor beyond it. | |
| transcript | No | Search machine-generated speech-to-text transcripts (GDELT's asr: operator). Repeatable; multiple values are OR'd together. Short phrases only (GDELT caps each at 5 words). | |
| day_of_week | No | Limit to a day of week, 0 (Sunday) through 7 (Saturday), PST. | |
| onscreen_text | No | Search OCR'd onscreen text/chyrons (GDELT's ocr: operator). Repeatable; multiple values are OR'd together. Short phrases only (GDELT caps each at 5 words). | |
| exclude_visual | No | Exclude clips whose visual labels match this value (GDELT's -visual: operator). Repeatable; every value must be absent. | |
| exclude_caption | No | Exclude clips whose closed captioning matches this value (GDELT's -cap: operator). Repeatable; every value must be absent. | |
| exclude_concept | No | Exclude clips whose extracted concepts match this MID code (GDELT's -capnlp: operator). Repeatable; every value must be absent. | |
| exclude_transcript | No | Exclude clips whose speech-to-text transcript matches this value (GDELT's -asr: operator). Repeatable; every value must be absent. | |
| exclude_onscreen_text | No | Exclude clips whose OCR'd onscreen text matches this value (GDELT's -ocr: operator). Repeatable; every value must be absent. |