Skip to main content
GET
/
api
/
intelligence
/
v1
/
search-gdelt-documents
SearchGdeltDocuments
curl --request GET \
  --url https://api.example.com/api/intelligence/v1/search-gdelt-documents
{
  "articles": [
    {
      "title": "<string>",
      "url": "<string>",
      "source": "<string>",
      "date": "<string>",
      "image": "<string>",
      "language": "<string>",
      "tone": 123
    }
  ],
  "query": "<string>",
  "error": "<string>"
}

Query Parameters

query
string

Search query string.

max_records
integer<int32>

Maximum number of articles to return (1-250).

timespan
string

Time span filter (e.g., "15min", "1h", "24h").

tone_filter
string

Tone filter appended to query (e.g., "tone>5" for positive, "tone<-5" for negative). Left empty to skip tone filtering.

sort
string

Sort mode: "DateDesc" (default), "ToneDesc", "ToneAsc", "HybridRel".

Response

Successful response

SearchGdeltDocumentsResponse contains GDELT article search results.

articles
object[]
query
string

Echo of the search query.

error
string

Error message if the search failed.