---
title: "Compare US television news coverage across stations"
method: GET
path: "/gdelt/tv-stationchart"
tags: ["GDELT"]
---

# Compare US television news coverage across stations

`GET /gdelt/tv-stationchart`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/gdelt/tv-stationchart`
- Auth: API key in header `x-api-key`

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`.

## Query parameters

- `transcript` string[]
- `caption` string[]
- `concept` string[]
- `onscreen_text` string[]
- `visual` string[]
- `exclude_transcript` string[]
- `exclude_caption` string[]
- `exclude_concept` string[]
- `exclude_onscreen_text` string[]
- `exclude_visual` string[]
- `station` string[], required
- `show` string
- `timespan` string
- `from` string
- `to` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- GdeltTvStationChartResponseDoc
  - `code` integer
  - `data` GdeltTVStationChartResponse
    - `fetched_at` string
    - `query` string
    - `source_url` string
    - `stations` GdeltTVStationCount[]
      - `count` integer
      - `station` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)