Docs menu

GDELT API endpoint

GDELT Television Concept Entities API

Lists the Google Knowledge Graph concept entities GDELT recognises in US television captioning, most frequent first, up to `limit` entries (default 100, max 10000). Each has a display `label` and a `mid` code. Pass the `mid`, not the label, as `concept` to the GDELT TV search and chart endpoints. The list does not depend on any query.

GETapiKey0 credits/requestGDELTgdelt.tvCapNlpEntityDetailsResponseDoc/gdelt/tv-concept-entities

Endpoint facts

Method: GET
API path: /gdelt/tv-concept-entities
Auth: apiKey
Credits: 0 credits/request
Charged on: Successful 2xx responses only
Platform: GDELT
Response schema: #/definitions/gdelt.tvCapNlpEntityDetailsResponseDoc

GDELT News Monitoring API Try GDELT Television Concept Entities API in Playground GDELT API documentation

How this endpoint behaves

Path parameters:

None.

Query parameters:

limit (optional) — maximum entries to return, most-frequent first. Default 100, maximum 10000.

Notable 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[].mid is the exact string to pass as concept on gdelt-tv-search/gdelt-tv-timeline/gdelt-tv-stationchart/gdelt-tv-showchart. entities[].label is for display only — GDELT does not accept the label itself as a 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 concept vocabulary grows.

Sampled response

Request, 14 Oct 2026: GET /gdelt/tv-concept-entities?limit=40
Items in entities: 40
Fields filled in every checked item: 2

Field	Filled in, of 40 checked	Values in the sample
mid	40	“/m/09c7w0” and 39 other values
label	40	“U.S.” and 38 other values

Request parameters

Parameter	Type	Required	Default	Description	Example
limit	integer	No		Maximum entries to return, most-frequent first. Minimum: 1. Maximum: 10000.
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/gdelt/tv-concept-entities?limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://api.gdeltproject.org/api/v2/tvai/tvai?format=json&mode=capnlpentitydetails&maxrecords=100",
    "fetched_at": "2026-08-20T10:00:00Z",
    "entities": [
      {
        "mid": "/m/09c7w0",
        "label": "U.S."
      },
      {
        "mid": "/m/0cqt90",
        "label": "DONALD TRUMP"
      },
      {
        "mid": "/m/016bvz",
        "label": "NBC NEWS"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/gdelt.tvCapNlpEntityDetailsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	gdelt.TVCapNlpEntityDetailsResponse	No
data.entities	array	No
data.entities[].label	string	No	DONALD TRUMP
data.entities[].mid	string	No	/m/0cqt90
data.fetched_at	string	No	2026-08-20T10:00:00Z
data.source_url	string	No	https://api.gdeltproject.org/api/v2/tvai/tvai?format=json&mode=capnlpentitydetails&maxrecords=100
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/gdelt/tv-concept-entities?limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More GDELT endpoint docs GDELT News Monitoring API GDELT Context Search API documentation GDELT Search API documentation GDELT Timeline API documentation GDELT Tone Chart API documentation GDELT Television Search API documentation GDELT Television Show Chart API documentation

Open in Playground Back to group

Docs menu

GDELT API endpoint

GDELT Television Concept Entities API

GETapiKey0 credits/requestGDELTgdelt.tvCapNlpEntityDetailsResponseDoc/gdelt/tv-concept-entities

Endpoint facts

Method: GET
API path: /gdelt/tv-concept-entities
Auth: apiKey
Credits: 0 credits/request
Charged on: Successful 2xx responses only
Platform: GDELT
Response schema: #/definitions/gdelt.tvCapNlpEntityDetailsResponseDoc

GDELT News Monitoring API Try GDELT Television Concept Entities API in Playground GDELT API documentation

How this endpoint behaves

Path parameters:

None.

Query parameters:

limit (optional) — maximum entries to return, most-frequent first. Default 100, maximum 10000.

Notable 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[].mid is the exact string to pass as concept on gdelt-tv-search/gdelt-tv-timeline/gdelt-tv-stationchart/gdelt-tv-showchart. entities[].label is for display only — GDELT does not accept the label itself as a 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 concept vocabulary grows.

Sampled response

Request, 14 Oct 2026: GET /gdelt/tv-concept-entities?limit=40
Items in entities: 40
Fields filled in every checked item: 2

Field	Filled in, of 40 checked	Values in the sample
mid	40	“/m/09c7w0” and 39 other values
label	40	“U.S.” and 38 other values

Request parameters

Parameter	Type	Required	Default	Description	Example
limit	integer	No		Maximum entries to return, most-frequent first. Minimum: 1. Maximum: 10000.
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/gdelt/tv-concept-entities?limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://api.gdeltproject.org/api/v2/tvai/tvai?format=json&mode=capnlpentitydetails&maxrecords=100",
    "fetched_at": "2026-08-20T10:00:00Z",
    "entities": [
      {
        "mid": "/m/09c7w0",
        "label": "U.S."
      },
      {
        "mid": "/m/0cqt90",
        "label": "DONALD TRUMP"
      },
      {
        "mid": "/m/016bvz",
        "label": "NBC NEWS"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/gdelt.tvCapNlpEntityDetailsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	gdelt.TVCapNlpEntityDetailsResponse	No
data.entities	array	No
data.entities[].label	string	No	DONALD TRUMP
data.entities[].mid	string	No	/m/0cqt90
data.fetched_at	string	No	2026-08-20T10:00:00Z
data.source_url	string	No	https://api.gdeltproject.org/api/v2/tvai/tvai?format=json&mode=capnlpentitydetails&maxrecords=100
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/gdelt/tv-concept-entities?limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

GDELT Television Concept Entities API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

GDELT Television Concept Entities API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related