GDELT

Word cloud for US television news coverage

Returns a frequency-ranked word cloud for US television coverage. channel is required and picks what is counted: transcript, caption, concept, onscreen_text or visual; station is also required. Match with the same channel options (with exclude_ counterparts) and limit by show, day_of_week, timespan or from and to. Each word has a label and count.

get/gdelt/tv-wordcloud

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/gdelt/tv-wordcloud
  • Auth: API key in header x-api-key

Query parameters

channel'transcript' | 'caption' | 'concept' | 'onscreen_text' | 'visual' required

Required. Which match channel to build a word cloud from.

transcriptstring[]

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).

captionstring[]

Search human-provided closed captioning (GDELT's cap: operator). Repeatable; multiple values are OR'd together.

conceptstring[]

Search Google Knowledge Graph concepts extracted from captioning, by MID code (GDELT's capnlp: operator). Repeatable; multiple values are OR'd together.

onscreen_textstring[]

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).

visualstring[]

Search visual object/activity labels from computer vision (GDELT's visual: operator). Repeatable; multiple values are OR'd together.

exclude_transcriptstring[]

Exclude clips whose speech-to-text transcript matches this value (GDELT's -asr: operator). Repeatable; every value must be absent.

exclude_captionstring[]

Exclude clips whose closed captioning matches this value (GDELT's -cap: operator). Repeatable; every value must be absent.

exclude_conceptstring[]

Exclude clips whose extracted concepts match this MID code (GDELT's -capnlp: operator). Repeatable; every value must be absent.

exclude_onscreen_textstring[]

Exclude clips whose OCR'd onscreen text matches this value (GDELT's -ocr: operator). Repeatable; every value must be absent.

exclude_visualstring[]

Exclude clips whose visual labels match this value (GDELT's -visual: operator). Repeatable; every value must be absent.

station'CNN' | 'MSNBC' | 'FOXNEWS' | 'BBCNEWS' | 'KGO' | 'KPIX' | 'KNTV' required

Required. Station to search.

showstring

Limit to an exact show name.

day_of_weekstring

Limit to a day of week, 0 (Sunday) through 7 (Saturday), PST.

timespanstring

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.

fromstring

Start of an absolute time window. Accepts YYYY-MM-DD, RFC3339, or GDELT's raw YYYYMMDDHHMMSS. Cannot be combined with timespan.

tostring

End of an absolute time window. Same formats as from.

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "channel": "caption",
    "fetched_at": "2026-08-20T10:00:00Z",
    "query": "cap:\"trump\" station:CNN",
    "source_url": "https://api.gdeltproject.org/api/v2/tvai/tvai?format=json&mode=wordcloudcap&query=cap%3A%22trump%22+station%3ACNN",
    "words": [
      {
        "count": 100,
        "label": "Trump"
      }
    ]
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.