---
title: "Word cloud for US television news coverage"
method: GET
path: "/gdelt/tv-wordcloud"
tags: ["GDELT"]
---

# Word cloud for US television news coverage

`GET /gdelt/tv-wordcloud`

## Request

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

Returns a frequency-ranked word cloud for US television coverage. `channel` is required and picks what is counted: `transcript`, `caption`, `concept`, `onscreen_text` or `visual`; `station` is also required. Match with the same channel options (with `exclude_` counterparts) and limit by `show`, `day_of_week`, `timespan` or `from` and `to`. Each word has a `label` and `count`.

## Query parameters

- `channel` 'transcript' | 'caption' | 'concept' | 'onscreen_text' | 'visual', required
- `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` 'CNN' | 'MSNBC' | 'FOXNEWS' | 'BBCNEWS' | 'KGO' | 'KPIX' | 'KNTV', required
- `show` string
- `day_of_week` string
- `timespan` string
- `from` string
- `to` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- GdeltTvWordCloudResponseDoc
  - `code` integer
  - `data` GdeltTVWordCloudResponse
    - `channel` string
    - `fetched_at` string
    - `query` string
    - `source_url` string
    - `words` GdeltTVWordCloudEntry[]
      - `count` number
      - `label` 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/028417aa35bb?raw)