tv: Search TV transcripts

API: gdeltproject.org:gdelt-api
Endpoint: /api/v2/tv/tv
Response format: text/plain
Auth: none
Method: GET
Last Status: 200
Latency: 15349ms

Description

Query the GDELT TV API to search television broadcast transcripts from monitored stations. Requires at least one station in the query.

Parameters (4)

format (string, query, optional, default: json)

Response format

Constraints: {'enum': ['json', 'csv']}

maxrecords (integer, query, optional, default: 10)

Maximum number of records to return

Constraints: {'minimum': 1, 'maximum': 250}

mode (string, query, required)

Response mode

Constraints: {'enum': ['ClipGallery', 'ArtList']}

query (string, query, required)

Search query. Must include at least one station identifier.

Examples (2)

Search TV transcripts openapi-spec
curl 'https://api.gdeltproject.org/api/v2/tv/tv?query=station%3ABBCNEWS+climate&mode=ClipGallery'
import requests

resp = requests.get(
    "https://api.gdeltproject.org/api/v2/tv/tv",
    params={
        'query': 'station:BBCNEWS climate',
        'mode': 'ClipGallery',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("gdeltproject")
result = api.fetch("api/v2/tv/tv", query="station:BBCNEWS climate", mode="ClipGallery")

for item in result:
    print(item)
const resp = await fetch("https://api.gdeltproject.org/api/v2/tv/tv?query=station%3ABBCNEWS+climate&mode=ClipGallery");
const data = await resp.json();
Search TV transcripts probe-gate
curl 'https://api.gdeltproject.org/api/v2/tv/tv?query=station%3ABBCNEWS+climate&mode=ClipGallery&maxrecords=10&format=json'
import requests

resp = requests.get(
    "https://api.gdeltproject.org/api/v2/tv/tv",
    params={
        'query': 'station:BBCNEWS climate',
        'mode': 'ClipGallery',
        'maxrecords': '10',
        'format': 'json',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("gdeltproject")
result = api.fetch("api/v2/tv/tv", query="station:BBCNEWS climate", mode="ClipGallery", maxrecords=10, format="json")

for item in result:
    print(item)
const resp = await fetch("https://api.gdeltproject.org/api/v2/tv/tv?query=station%3ABBCNEWS+climate&mode=ClipGallery&maxrecords=10&format=json");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 02:53:06.529591 200 15349ms
2026-04-16 00:40:29.858089 200 19263ms
2026-04-15 01:52:28.241944 200 5413ms
2026-04-15 00:46:23.275629 200 3690ms
2026-04-14 03:26:07.348142 200 2173ms
2026-04-14 02:21:37.116660 200 2883ms
2026-04-12 15:48:32.809582 200 1551ms
2026-04-12 15:40:23.176162 200 4010ms
2026-04-10 06:48:04.597678 200 6292ms
2026-04-10 01:08:59.127092 200 9018ms
2026-04-09 02:42:37.925389 200 6531ms
2026-04-09 02:11:42.948089 200 7856ms
2026-04-08 07:03:27.562417 200 12085ms
2026-04-08 00:23:36.829080 200 16763ms
2026-04-07 00:52:31.782889 200 11542ms
2026-04-07 00:51:03.809046 200 19875ms
2026-04-06 05:09:10.172505 200 6216ms
2026-04-06 04:41:23.142134 200 1619ms
2026-04-05 14:26:41.565398 200 4296ms
2026-04-05 14:25:37.858283 200 2305ms
2026-03-27T11:37:34.354657 200 14409ms