Endpoint Playground

Try the GDELT Television Search API

Searches GDELT's US television news index on one required `station` (`CNN`, `MSNBC`, `FOXNEWS`, `BBCNEWS`, `KGO`, `KPIX` or `KNTV`). Match on `transcript`, `caption`, `concept`, `onscreen_text` or `visual`, with matching `exclude_` options. Returns up to `maxrecords` clips (default 50, max 3000) with show, station, timing, caption, transcript, onscreen text and clip URL. Results lag 24 to 48 hours.

What a live request returned

14 Oct 2026: 50 clips; 8 fields had a value in every checked item and 3 varied between items.

Observed request: GET /gdelt/tv-search?caption=climate&station=CNN
Fields with a value in every checked item: station, show, show_start_at, matched_at, transcript, caption, clip_url, thumbnail_url

Sample value profiles: show_start_at: 2011-06-02 to 2024-09-07; show: “Inside Politics” and 32 other values; clip_url: archive.org.

Request: GET /gdelt/tv-search
Cost: 0 credits/request
Auth: apiKey

GDELT Television Search API documentation GDELT platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/gdelt/tv-search?station=CNN&sort=relevance' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
transcript	array	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).
caption	array	No		Search human-provided closed captioning (GDELT's cap: operator). Repeatable; multiple values are OR'd together.
concept	array	No		Search Google Knowledge Graph concepts extracted from captioning, by MID code (GDELT's capnlp: operator). Repeatable; multiple values are OR'd together.
onscreen_text	array	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).
visual	array	No		Search visual object/activity labels from computer vision (GDELT's visual: operator). Repeatable; multiple values are OR'd together.
exclude_transcript	array	No		Exclude clips whose speech-to-text transcript matches this value (GDELT's -asr: operator). Repeatable; every value must be absent.
exclude_caption	array	No		Exclude clips whose closed captioning matches this value (GDELT's -cap: operator). Repeatable; every value must be absent.
exclude_concept	array	No		Exclude clips whose extracted concepts match this MID code (GDELT's -capnlp: operator). Repeatable; every value must be absent.
exclude_onscreen_text	array	No		Exclude clips whose OCR'd onscreen text matches this value (GDELT's -ocr: operator). Repeatable; every value must be absent.
exclude_visual	array	No		Exclude clips whose visual labels match this value (GDELT's -visual: operator). Repeatable; every value must be absent.
station	string	Yes	CNN	Station to search.
show	string	No		Limit to an exact show name.
day_of_week	integer	No		Limit to a day of week, 0 (Sunday) through 7 (Saturday), PST.
timespan	string	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.
from	string	No		Start of an absolute time window. Accepts YYYY-MM-DD, RFC3339, or GDELT's raw YYYYMMDDHHMMSS. Cannot be combined with timespan.
to	string	No		End of an absolute time window. Same formats as from.
sort	string	No	relevance	Result order.
maxrecords	integer	No		Rows to return. GDELT's own hard cap is 3000 for this endpoint; there is no pagination cursor beyond it.

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "cap:\"climate change\" station:CNN",
    "station": "CNN",
    "sort": "relevance",
    "maxrecords": 50,
    "count": 1,
    "source_url": "https://api.gdeltproject.org/api/v2/tvai/tvai?format=json&maxrecords=50&mode=clipgallery&query=cap%3A%22climate+change%22+station%3ACNN",
    "fetched_at": "2026-08-20T10:00:00Z",
    "clips": [
      {
        "station": "cnn",
        "show": "Inside Politics",
        "show_start_at": "2019-05-03T16:00:00Z",
        "matched_at": "2019-05-03T17:00:56Z",
        "transcript": "climate change the",
        "caption": "climate",
        "onscreen_text": "SWEEPING PLAN LIVE",
        "visual_entities": [
          "person",
          "news",
          "facial expression"
        ],
        "clip_url": "https://archive.org/details/CNNW_20190503_160000_Inside_Politics/start/3656",
        "thumbnail_url": "http://data.gdeltproject.org/televisionexplorer/thumbnails/CNNW_20190503_160000_Inside_Politics-003656.jpg"
      }
    ]
  }
}

More GDELT endpoints

Sentence-level co-occurrence search across recent GDELT coverage Search global news coverage indexed by GDELT Coverage volume or tone over time for a GDELT query Sentiment histogram for a GDELT query List GDELT Television 2.0 AI concept entities Top US television shows by coverage share for a query Compare US television news coverage across stations List GDELT Television 2.0 AI stations Airtime volume over time for US television news coverage List GDELT Television 2.0 AI visual entities Word cloud for US television news coverage

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey0 credits/requestgdelt.tvSearchResponseDocGDELT

GET /gdelt/tv-search

Search US television news coverage (transcripts, captions, OCR, visual labels)

Response behavior

- `matched_at` is the exact timestamp of the matched moment within the broadcast; `show_start_at` is when the containing show began. - `visual_entities` is returned as a list. - `count` is the number of clips actually returned (0 is a valid, legitimate "no matches" result, distinct from an upstream error). - `source_url` is the exact upstream GDELT Television 2.0 AI API URL used for the call. - A GDELT-side rate limit, an all-too-common ASR/caption/OCR phrase, a date outside the archive's range, or an unrecognized/malformed upstream response surfaces as a `503` upstream error, not a `200` with empty/wrong data.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

station

requiredstring

Station to search. · allowed: CNN, MSNBC, FOXNEWS, BBCNEWS, KGO, KPIX, KNTV

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "cap:\"climate change\" station:CNN",
    "station": "CNN",
    "sort": "relevance",
    "maxrecords": 50,
    "count": 1,
    "source_url": "https://api.gdeltproject.org/api/v2/tvai/tvai?format=json&maxrecords=50&mode=clipgallery&query=cap%3A%22climate+change%22+station%3ACNN",
    "fetched_at": "2026-08-20T10:00:00Z",
    "clips": [
      {
        "station": "cnn",
        "show": "Inside Politics",
        "show_start_at": "2019-05-03T16:00:00Z",
        "matched_at": "2019-05-03T17:00:56Z",
        "transcript": "climate change the",
        "caption": "climate",
        "onscreen_text": "SWEEPING PLAN LIVE",
        "visual_entities": [
          "person",
          "news",
          "facial expression"
        ],
        "clip_url": "https://archive.org/details/CNNW_20190503_160000_Inside_Politics/start/3656",
        "thumbnail_url": "http://data.gdeltproject.org/televisionexplorer/thumbnails/CNNW_20190503_160000_Inside_Politics-003656.jpg"
      }
    ]
  }
}

Try the GDELT Television Search API

What a live request returned

14 Oct 2026: 50 clips; 8 fields had a value in every checked item and 3 varied between items.

Observed request: GET /gdelt/tv-search?caption=climate&station=CNN
Fields with a value in every checked item: station, show, show_start_at, matched_at, transcript, caption, clip_url, thumbnail_url

Sample value profiles: show_start_at: 2011-06-02 to 2024-09-07; show: “Inside Politics” and 32 other values; clip_url: archive.org.

Request: GET /gdelt/tv-search
Cost: 0 credits/request
Auth: apiKey

GDELT Television Search API documentation GDELT platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/gdelt/tv-search?station=CNN&sort=relevance' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
transcript	array	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).
caption	array	No		Search human-provided closed captioning (GDELT's cap: operator). Repeatable; multiple values are OR'd together.
concept	array	No		Search Google Knowledge Graph concepts extracted from captioning, by MID code (GDELT's capnlp: operator). Repeatable; multiple values are OR'd together.
onscreen_text	array	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).
visual	array	No		Search visual object/activity labels from computer vision (GDELT's visual: operator). Repeatable; multiple values are OR'd together.
exclude_transcript	array	No		Exclude clips whose speech-to-text transcript matches this value (GDELT's -asr: operator). Repeatable; every value must be absent.
exclude_caption	array	No		Exclude clips whose closed captioning matches this value (GDELT's -cap: operator). Repeatable; every value must be absent.
exclude_concept	array	No		Exclude clips whose extracted concepts match this MID code (GDELT's -capnlp: operator). Repeatable; every value must be absent.
exclude_onscreen_text	array	No		Exclude clips whose OCR'd onscreen text matches this value (GDELT's -ocr: operator). Repeatable; every value must be absent.
exclude_visual	array	No		Exclude clips whose visual labels match this value (GDELT's -visual: operator). Repeatable; every value must be absent.
station	string	Yes	CNN	Station to search.
show	string	No		Limit to an exact show name.
day_of_week	integer	No		Limit to a day of week, 0 (Sunday) through 7 (Saturday), PST.
timespan	string	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.
from	string	No		Start of an absolute time window. Accepts YYYY-MM-DD, RFC3339, or GDELT's raw YYYYMMDDHHMMSS. Cannot be combined with timespan.
to	string	No		End of an absolute time window. Same formats as from.
sort	string	No	relevance	Result order.
maxrecords	integer	No		Rows to return. GDELT's own hard cap is 3000 for this endpoint; there is no pagination cursor beyond it.

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "cap:\"climate change\" station:CNN",
    "station": "CNN",
    "sort": "relevance",
    "maxrecords": 50,
    "count": 1,
    "source_url": "https://api.gdeltproject.org/api/v2/tvai/tvai?format=json&maxrecords=50&mode=clipgallery&query=cap%3A%22climate+change%22+station%3ACNN",
    "fetched_at": "2026-08-20T10:00:00Z",
    "clips": [
      {
        "station": "cnn",
        "show": "Inside Politics",
        "show_start_at": "2019-05-03T16:00:00Z",
        "matched_at": "2019-05-03T17:00:56Z",
        "transcript": "climate change the",
        "caption": "climate",
        "onscreen_text": "SWEEPING PLAN LIVE",
        "visual_entities": [
          "person",
          "news",
          "facial expression"
        ],
        "clip_url": "https://archive.org/details/CNNW_20190503_160000_Inside_Politics/start/3656",
        "thumbnail_url": "http://data.gdeltproject.org/televisionexplorer/thumbnails/CNNW_20190503_160000_Inside_Politics-003656.jpg"
      }
    ]
  }
}

Search US television news coverage (transcripts, captions, OCR, visual labels)

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "query": "cap:\"climate change\" station:CNN", "station": "CNN", "sort": "relevance", "maxrecords": 50, "count": 1, "source_url": "https://api.gdeltproject.org/api/v2/tvai/tvai?format=json&maxrecords=50&mode=clipgallery&query=cap%3A%22climate+change%22+station%3ACNN", "fetched_at": "2026-08-20T10:00:00Z", "clips": [ { "station": "cnn", "show": "Inside Politics", "show_start_at": "2019-05-03T16:00:00Z", "matched_at": "2019-05-03T17:00:56Z", "transcript": "climate change the", "caption": "climate", "onscreen_text": "SWEEPING PLAN LIVE", "visual_entities": [ "person", "news", "facial expression" ], "clip_url": "https://archive.org/details/CNNW_20190503_160000_Inside_Politics/start/3656", "thumbnail_url": "http://data.gdeltproject.org/televisionexplorer/thumbnails/CNNW_20190503_160000_Inside_Politics-003656.jpg" } ] } }