Endpoint Playground

Try the GDELT Television Station Chart API

Test Crawlora's GDELT Television Station Chart API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.

Endpoint facts

Method: GET
API path: /gdelt/tv-stationchart
Platform: GDELT
Auth: apiKey
Credits: 0 credits/request
Required params: station
Common optional params: transcript, caption, concept, onscreen_text, visual, exclude_transcript

GDELT Television Station Chart API documentation GDELT platform page Crawlora API pricing Try GDELT Context Search API Try GDELT Search API Try GDELT Timeline API Try GDELT Tone Chart API Try GDELT Television Concept Entities API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/gdelt/tv-stationchart?station=<station>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	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	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.

Example JSON response

{
  "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
      }
    ]
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey0 credits/requestgdelt.tvStationChartResponseDocGDELT

GET /gdelt/tv-stationchart

Compare US television news coverage across stations

Return a result-count comparison across the requested

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

requiredarray

Required, repeatable. One or more stations, OR'd together.

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:\"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
      }
    ]
  }
}

Endpoint details

Return a result-count comparison across the requested

Method: GET
Path: /gdelt/tv-stationchart
Authentication: apiKey
Credit cost: 0 credits/request
Platform: GDELT
Parameters: 16 documented fields

Request parameters

transcript:querycaption:queryconcept:queryonscreen_text:queryvisual:queryexclude_transcript:queryexclude_caption:queryexclude_concept:queryexclude_onscreen_text:queryexclude_visual:querystation:queryshow:query+4 more

Response schema fields

codedatadata.fetched_atdata.querydata.source_urldata.stationsdata.stations[].countdata.stations[].stationmsg

Sample response summary

{
  "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
      }
    ]
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/gdelt/tv-stationchart?station=<station>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing 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

Endpoint Playground

Try the GDELT Television Station Chart API

Endpoint facts

Method: GET
API path: /gdelt/tv-stationchart
Platform: GDELT
Auth: apiKey
Credits: 0 credits/request
Required params: station
Common optional params: transcript, caption, concept, onscreen_text, visual, exclude_transcript

Prefilled cURL

curl "https://api.crawlora.net/api/v1/gdelt/tv-stationchart?station=<station>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	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	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.

Example JSON response

{
  "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
      }
    ]
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey0 credits/requestgdelt.tvStationChartResponseDocGDELT

GET /gdelt/tv-stationchart

Compare US television news coverage across stations

Return a result-count comparison across the requested

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

requiredarray

Required, repeatable. One or more stations, OR'd together.

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:\"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
      }
    ]
  }
}

Endpoint details

Return a result-count comparison across the requested

Method: GET
Path: /gdelt/tv-stationchart
Authentication: apiKey
Credit cost: 0 credits/request
Platform: GDELT
Parameters: 16 documented fields

Request parameters

Response schema fields

codedatadata.fetched_atdata.querydata.source_urldata.stationsdata.stations[].countdata.stations[].stationmsg

Sample response summary

{
  "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
      }
    ]
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/gdelt/tv-stationchart?station=<station>" \
  -H "x-api-key: $CRAWLORA_API_KEY"