Endpoint Playground

Try the GDELT Context Search API

Test Crawlora's GDELT Context Search API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.

Endpoint facts

Method: GET
API path: /gdelt/context
Platform: GDELT
Auth: apiKey
Credits: 0 credits/request
Required params: query
Common optional params: domain, language, is_quote, timespan, from, to

GDELT Context Search API documentation GDELT platform page Crawlora API pricing Try GDELT Search API Try GDELT Timeline API Try GDELT Tone Chart API Try GDELT Television Concept Entities API Try GDELT Television Search API

Prefilled cURL

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

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
query	string	Yes		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."
      }
    ]
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

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

Search recent (last 72 hours) GDELT-monitored news for

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 details

Search recent (last 72 hours) GDELT-monitored news for

Method: GET
Path: /gdelt/context
Authentication: apiKey
Credit cost: 0 credits/request
Platform: GDELT
Parameters: 10 documented fields

Request parameters

query:querydomain:querylanguage:queryis_quote:querytimespan:queryfrom:queryto:querysort:querymaxrecords:queryx-api-key:header

Response schema fields

codedatadata.articlesdata.articles[].contextdata.articles[].domaindata.articles[].is_quotedata.articles[].languagedata.articles[].seen_atdata.articles[].sentencedata.articles[].social_image_urldata.articles[].titledata.articles[].url

Sample response summary

{
  "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."
      }
    ]
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/gdelt/context?query=<query>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing 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)

Endpoint Playground

Try the GDELT Context Search API

Endpoint facts

Method: GET
API path: /gdelt/context
Platform: GDELT
Auth: apiKey
Credits: 0 credits/request
Required params: query
Common optional params: domain, language, is_quote, timespan, from, to

Prefilled cURL

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

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
query	string	Yes		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."
      }
    ]
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

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

Search recent (last 72 hours) GDELT-monitored news for

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 details

Search recent (last 72 hours) GDELT-monitored news for

Method: GET
Path: /gdelt/context
Authentication: apiKey
Credit cost: 0 credits/request
Platform: GDELT
Parameters: 10 documented fields

Request parameters

query:querydomain:querylanguage:queryis_quote:querytimespan:queryfrom:queryto:querysort:querymaxrecords:queryx-api-key:header

Response schema fields

Sample response summary

{
  "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."
      }
    ]
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/gdelt/context?query=<query>" \
  -H "x-api-key: $CRAWLORA_API_KEY"