GDELT

Airtime volume over time for US television news coverage

Returns the amount of US television news airtime matching the supplied query over time, using GDELT Television 2.0 AI timeline-volume data. A station is required. Supports the same caption, transcript, concept, and visual match operators as gdelt-tv-search; coverage and processing-delay caveats are documented there.

get/gdelt/tv-timeline

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/gdelt/tv-timeline
  • 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.

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

Station to search.

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:\"climate change\" station:CNN",
    "series": [
      {
        "points": [
          {
            "date": "2026-08-19T00:00:00Z",
            "value": 1.42
          }
        ],
        "series": "climate change"
      }
    ],
    "source_url": "https://api.gdeltproject.org/api/v2/tvai/tvai?format=json&mode=timelinevol&query=cap%3A%22climate+change%22+station%3ACNN",
    "station": "CNN"
  },
  "msg": "OK"
}

Changes

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