GDELT

Compare US television news coverage across stations

Compares how much each US television station covered a topic. At least one station is required, and several are compared side by side. A match is set with transcript, caption, concept, onscreen_text or visual (with exclude_ counterparts), optionally limited by show, timespan or from and to. Returns each station with a count.

get/gdelt/tv-stationchart

Request

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

Query parameters

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.

stationstring[] required

Required, repeatable. One or more stations, OR'd together.

showstring

Limit to an exact show name.

timespanstring

Relative time window ending now, e.g. 1h, 7d, 3m, 1y. Cannot be combined with from/to. Omit both for GDELT's full archive (auto-resolution, back to 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": {
    "fetched_at": "2026-08-20T10:00:00Z",
    "query": "cap:\"trump\" (station:CNN OR station:MSNBC)",
    "source_url": "https://api.gdeltproject.org/api/v2/tvai/tvai?format=json&mode=stationchart&query=cap%3A%22trump%22+%28station%3ACNN+OR+station%3AMSNBC%29",
    "stations": [
      {
        "count": 877267,
        "station": "CNN"
      }
    ]
  },
  "msg": "OK"
}

Changes

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