GDELT

Sentence-level co-occurrence search across recent GDELT coverage

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.

get/gdelt/context

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/gdelt/context
  • Auth: API key in header x-api-key

Query parameters

querystring required

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

domainstring

Convenience domain filter, appended to the query as domain:VALUE.

languagestring

Source-language filter (GDELT's searchlang parameter). Space-segmented languages only (excludes CJK and similar).

is_quoteboolean

Only return sentences GDELT identified as a quotation.

timespanstring

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.

fromstring

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.

tostring

End of an absolute time window. Same formats as from.

sort'relevance' | 'datedesc' | 'dateasc'

Result order.

maxrecordsinteger

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.

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

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

Changes

No recorded changes to this operation across all 2 revisions of this API.