Endpoint Playground

Try the GDELT Context Search API

Searches the last 72 hours of GDELT-monitored news for sentences where every term of the required `query` appears together. Returns up to `maxrecords` rows (default 75, max 200), each with the matching sentence, its surrounding context, title, URL, domain, language and an `is_quote` flag. Filter with `domain`, `language`, `is_quote`, `timespan` or `from` and `to`, and order with `sort`.

What a live request returned

14 Oct 2026: 74 articles; 8 fields had a value in every checked item and 1 varied between items.

Observed request: GET /gdelt/context?query=climate+%28flood+OR+drought%29&timespan=24h
Fields with a value in every checked item: url, title, seen_at, domain, language, is_quote, sentence, context

Sample value profiles: seen_at: 2026-10-13; title: “A historic El Niño is gathering strength. Heres how to prep…” and 30 other values; url: pressdemocrat.com and 69 other hosts.

Request: GET /gdelt/context
Cost: 0 credits/request
Auth: apiKey

GDELT Context Search API documentation GDELT platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/gdelt/context?query=climate+change&sort=relevance' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
query	string	Yes	climate change	GDELT query string. All terms must co-occur in the same sentence. Supports quoted phrases, (a OR b), domain:example.com.
domain	string	No		Convenience domain filter, appended to the query as domain:VALUE.
language	string	No		Source-language filter (GDELT's searchlang parameter). Space-segmented languages only (excludes CJK and similar).
is_quote	boolean	No		Only return sentences GDELT identified as a quotation.
timespan	string	No		Relative time window ending now, e.g. 30min, 6h, 3d. Cannot be combined with from/to. GDELT caps this endpoint's window at 72 hours.
from	string	No		Start of an absolute time window. Accepts YYYY-MM-DD, RFC3339, or GDELT's raw YYYYMMDDHHMMSS. Cannot be combined with timespan; GDELT caps this endpoint's window at 72 hours.
to	string	No		End of an absolute time window. Same formats as from.
sort	string	No	relevance	Result order.
maxrecords	integer	No		Rows to return. GDELT's own hard cap is 200 for this endpoint (lower than gdelt-search's 250); there is no pagination cursor beyond it.

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "climate change",
    "sort": "relevance",
    "maxrecords": 75,
    "count": 1,
    "source_url": "https://api.gdeltproject.org/api/v2/context/context?format=json&maxrecords=75&mode=artlist&query=climate+change&timespan=24h",
    "fetched_at": "2026-08-20T10:00:00Z",
    "articles": [
      {
        "url": "https://www.example.com/news/climate-report",
        "title": "Climate report warns of rising sea levels",
        "seen_at": "2026-08-19T23:00:00Z",
        "domain": "example.com",
        "language": "ENGLISH",
        "social_image_url": "https://www.example.com/images/social.jpg",
        "is_quote": false,
        "sentence": "Coastal cities face rising seas driven by accelerating climate change.",
        "context": "The report, released Tuesday, warns that coastal cities face rising seas driven by accelerating climate change. Officials called for immediate action."
      }
    ]
  }
}

More GDELT endpoints

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 List GDELT Television 2.0 AI visual entities 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.contextResponseDocGDELT

GET /gdelt/context

Sentence-level co-occurrence search across recent GDELT coverage

Response behavior

- `sentence` is the single matching sentence (GDELT returns at most one matching sentence per article); `context` is the surrounding paragraph. - `count` is the number of articles actually returned (0 is a valid, legitimate "no matches" result, distinct from an upstream error). - `source_url` is the exact upstream GDELT Context API URL used for the call. - A GDELT-side rate limit, a timespan/date range GDELT itself rejects as out of its 72-hour window, or an unrecognized/malformed upstream response surfaces as a `503` upstream error, not a `200` with empty/wrong data. An out-of-range `timespan` is instead rejected client-side as a `400` before ever reaching GDELT (see the `timespan` note above); an out-of-range `from`/`to` combination is not independently validated client-side and falls through to GDELT's own `503`-classified rejection.

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

query

requiredstring

GDELT query string. All terms must co-occur in the same sentence. Supports quoted phrases, (a OR b), domain:example.com.

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": "climate change",
    "sort": "relevance",
    "maxrecords": 75,
    "count": 1,
    "source_url": "https://api.gdeltproject.org/api/v2/context/context?format=json&maxrecords=75&mode=artlist&query=climate+change&timespan=24h",
    "fetched_at": "2026-08-20T10:00:00Z",
    "articles": [
      {
        "url": "https://www.example.com/news/climate-report",
        "title": "Climate report warns of rising sea levels",
        "seen_at": "2026-08-19T23:00:00Z",
        "domain": "example.com",
        "language": "ENGLISH",
        "social_image_url": "https://www.example.com/images/social.jpg",
        "is_quote": false,
        "sentence": "Coastal cities face rising seas driven by accelerating climate change.",
        "context": "The report, released Tuesday, warns that coastal cities face rising seas driven by accelerating climate change. Officials called for immediate action."
      }
    ]
  }
}

Endpoint Playground

Try the GDELT Context Search API

What a live request returned

14 Oct 2026: 74 articles; 8 fields had a value in every checked item and 1 varied between items.

Observed request: GET /gdelt/context?query=climate+%28flood+OR+drought%29&timespan=24h
Fields with a value in every checked item: url, title, seen_at, domain, language, is_quote, sentence, context

Sample value profiles: seen_at: 2026-10-13; title: “A historic El Niño is gathering strength. Heres how to prep…” and 30 other values; url: pressdemocrat.com and 69 other hosts.

Request: GET /gdelt/context
Cost: 0 credits/request
Auth: apiKey

GDELT Context Search API documentation GDELT platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/gdelt/context?query=climate+change&sort=relevance' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
query	string	Yes	climate change	GDELT query string. All terms must co-occur in the same sentence. Supports quoted phrases, (a OR b), domain:example.com.
domain	string	No		Convenience domain filter, appended to the query as domain:VALUE.
language	string	No		Source-language filter (GDELT's searchlang parameter). Space-segmented languages only (excludes CJK and similar).
is_quote	boolean	No		Only return sentences GDELT identified as a quotation.
timespan	string	No		Relative time window ending now, e.g. 30min, 6h, 3d. Cannot be combined with from/to. GDELT caps this endpoint's window at 72 hours.
from	string	No		Start of an absolute time window. Accepts YYYY-MM-DD, RFC3339, or GDELT's raw YYYYMMDDHHMMSS. Cannot be combined with timespan; GDELT caps this endpoint's window at 72 hours.
to	string	No		End of an absolute time window. Same formats as from.
sort	string	No	relevance	Result order.
maxrecords	integer	No		Rows to return. GDELT's own hard cap is 200 for this endpoint (lower than gdelt-search's 250); there is no pagination cursor beyond it.

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "climate change",
    "sort": "relevance",
    "maxrecords": 75,
    "count": 1,
    "source_url": "https://api.gdeltproject.org/api/v2/context/context?format=json&maxrecords=75&mode=artlist&query=climate+change&timespan=24h",
    "fetched_at": "2026-08-20T10:00:00Z",
    "articles": [
      {
        "url": "https://www.example.com/news/climate-report",
        "title": "Climate report warns of rising sea levels",
        "seen_at": "2026-08-19T23:00:00Z",
        "domain": "example.com",
        "language": "ENGLISH",
        "social_image_url": "https://www.example.com/images/social.jpg",
        "is_quote": false,
        "sentence": "Coastal cities face rising seas driven by accelerating climate change.",
        "context": "The report, released Tuesday, warns that coastal cities face rising seas driven by accelerating climate change. Officials called for immediate action."
      }
    ]
  }
}

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

GET /gdelt/context

Sentence-level co-occurrence search across recent GDELT coverage

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

Required query parameters

query

requiredstring

GDELT query string. All terms must co-occur in the same sentence. Supports quoted phrases, (a OR b), domain:example.com.

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": "climate change",
    "sort": "relevance",
    "maxrecords": 75,
    "count": 1,
    "source_url": "https://api.gdeltproject.org/api/v2/context/context?format=json&maxrecords=75&mode=artlist&query=climate+change&timespan=24h",
    "fetched_at": "2026-08-20T10:00:00Z",
    "articles": [
      {
        "url": "https://www.example.com/news/climate-report",
        "title": "Climate report warns of rising sea levels",
        "seen_at": "2026-08-19T23:00:00Z",
        "domain": "example.com",
        "language": "ENGLISH",
        "social_image_url": "https://www.example.com/images/social.jpg",
        "is_quote": false,
        "sentence": "Coastal cities face rising seas driven by accelerating climate change.",
        "context": "The report, released Tuesday, warns that coastal cities face rising seas driven by accelerating climate change. Officials called for immediate action."
      }
    ]
  }
}