GDELT

Top US television shows by coverage share for a query

Ranks US television shows by how much they covered a topic. At least one station is required, and 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 shows with a count. Omitting the time window searches the archive back to July 2010.

get/gdelt/tv-showchart

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/gdelt/tv-showchart
  • 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",
    "shows": [
      {
        "count": 7.8383,
        "show": "Anderson Cooper 360"
      }
    ],
    "source_url": "https://api.gdeltproject.org/api/v2/tvai/tvai?format=json&mode=showchart&query=cap%3A%22trump%22+station%3ACNN"
  },
  "msg": "OK"
}

Changes

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