Endpoint Playground

Try the GDELT Television Visual Entities API

Lists the computer-vision object and activity labels GDELT recognises in US television video, most frequent first, up to `limit` entries (default 100, max 10000). The label itself is the value to pass as `visual` to the GDELT TV search and chart endpoints. The list does not depend on any query.

What a live request returned

14 Oct 2026: 40 entities; 1 fields had a value in every checked item.

Observed request: GET /gdelt/tv-visual-entities?limit=40
Fields with a value in every checked item: label

Sample value profiles: label: “person” and 39 other values.

Request: GET /gdelt/tv-visual-entities
Cost: 0 credits/request
Auth: apiKey

GDELT Television Visual Entities API documentation GDELT platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/gdelt/tv-visual-entities' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
limit	integer	No		Maximum entries to return, most-frequent first.

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://api.gdeltproject.org/api/v2/tvai/tvai?format=json&mode=visualentitydetails&maxrecords=100",
    "fetched_at": "2026-08-20T10:00:00Z",
    "entities": [
      {
        "label": "person"
      },
      {
        "label": "snapshot"
      },
      {
        "label": "photograph"
      }
    ]
  }
}

More GDELT endpoints

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 Search US television news coverage (transcripts, captions, OCR, visual labels)Top US television shows by coverage share for a query Compare US television news coverage across stations List GDELT Television 2.0 AI stations Airtime volume over time for US television news coverage Word cloud for US television news coverage

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey0 credits/requestgdelt.tvVisualEntityDetailsResponseDocGDELT

GET /gdelt/tv-visual-entities

List GDELT Television 2.0 AI visual entities

Response behavior

- `entities` is query-independent — the same list every call returns, regardless of any other GDELT endpoint's query/station/time-range state. Only `limit` changes what comes back. - `entities[].label` is the exact string to pass as `visual` on gdelt-tv-search/gdelt-tv-timeline/gdelt-tv-stationchart/gdelt-tv-showchart — unlike [gdelt-tv-concept-entities](gdelt-tv-concept-entities.md)'s `mid`/`label` pair, visual labels have no separate code; the label itself is the search value. - `source_url` is the exact upstream GDELT Television 2.0 AI API URL used for the call. - Cached for longer (a few hours) than the rest of this platform, since this is reference data that only shifts as GDELT's own recognized visual vocabulary grows.

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

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": {
    "source_url": "https://api.gdeltproject.org/api/v2/tvai/tvai?format=json&mode=visualentitydetails&maxrecords=100",
    "fetched_at": "2026-08-20T10:00:00Z",
    "entities": [
      {
        "label": "person"
      },
      {
        "label": "snapshot"
      },
      {
        "label": "photograph"
      }
    ]
  }
}

Endpoint Playground

Try the GDELT Television Visual Entities API

What a live request returned

14 Oct 2026: 40 entities; 1 fields had a value in every checked item.

Observed request: GET /gdelt/tv-visual-entities?limit=40
Fields with a value in every checked item: label

Sample value profiles: label: “person” and 39 other values.

Request: GET /gdelt/tv-visual-entities
Cost: 0 credits/request
Auth: apiKey

GDELT Television Visual Entities API documentation GDELT platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/gdelt/tv-visual-entities' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
limit	integer	No		Maximum entries to return, most-frequent first.

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://api.gdeltproject.org/api/v2/tvai/tvai?format=json&mode=visualentitydetails&maxrecords=100",
    "fetched_at": "2026-08-20T10:00:00Z",
    "entities": [
      {
        "label": "person"
      },
      {
        "label": "snapshot"
      },
      {
        "label": "photograph"
      }
    ]
  }
}

More GDELT endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey0 credits/requestgdelt.tvVisualEntityDetailsResponseDocGDELT

GET /gdelt/tv-visual-entities

List GDELT Television 2.0 AI visual entities

Response behavior

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

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": {
    "source_url": "https://api.gdeltproject.org/api/v2/tvai/tvai?format=json&mode=visualentitydetails&maxrecords=100",
    "fetched_at": "2026-08-20T10:00:00Z",
    "entities": [
      {
        "label": "person"
      },
      {
        "label": "snapshot"
      },
      {
        "label": "photograph"
      }
    ]
  }
}