Endpoint Playground
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`.
14 Oct 2026: 1 stations; 2 fields had a value in every checked item.
Sample value profiles: station: “CNN”.
curl 'https://api.crawlora.net/api/v1/gdelt/tv-stationchart?station=CNN' \
-H "x-api-key: $CRAWLORA_API_KEY"| 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 | array | Yes | CNN | Required, repeatable. One or more stations, OR'd together. |
| show | string | No | Limit to an exact show name. | |
| timespan | string | No | 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). | |
| 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. |
{
"code": 200,
"msg": "OK",
"data": {
"query": "cap:\"trump\" (station:CNN OR station:MSNBC OR station:FOXNEWS)",
"source_url": "https://api.gdeltproject.org/api/v2/tvai/tvai?format=json&mode=stationchart&query=cap%3A%22trump%22+%28station%3ACNN+OR+station%3AMSNBC+OR+station%3AFOXNEWS%29",
"fetched_at": "2026-08-20T10:00:00Z",
"stations": [
{
"station": "CNN",
"count": 877267
},
{
"station": "FOXNEWS",
"count": 700230
},
{
"station": "MSNBC",
"count": 1135954
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.