What authentication does the GDELT DOC 2.0 API use?

GDELT's own DOC 2.0 documentation describes no credential for this API. It states that the API is accessed via a simple URL with the documented parameters, and every request example it publishes carries only parameters such as query, mode and timespan with nothing key-shaped attached; the spec declares no security scheme either. What the endpoint does enforce is a request rate, answering HTTP 429 with the message 'Please limit requests to one every 5 seconds' when it is called too quickly.

How far back does GDELT DOC 2.0 search go?

The DOC 2.0 endpoint covers a rolling three-month window of global news. For longer historical research, GDELT also publishes raw event and GKG bulk files separately, but those are outside the scope of the /doc/doc endpoint exposed here.

What output modes does the /doc/doc endpoint support?

The mode parameter controls the output: ArtList returns matching articles, TimelineVol returns the volume of matching coverage over time, TimelineTone returns its average tone, ImageCollage returns matching images processed by the GDELT Visual Global Knowledge Graph, and WordCloudImageTags returns a histogram of the topics tagged in that imagery. Mode is selected on the same single endpoint.

How do I run a GDELT search through Jentic?

Install self-hosted Jentic One from its GitHub repo, then search 'search global news'. Jentic returns the GET /doc/doc operation. Execute it with the query, mode (e.g. ArtList) and timespan parameters, and Jentic returns the structured response.

Is there a GDELT DOC 2.0 API MCP server?

You do not need an MCP server to give your agent GDELT DOC 2.0. Jentic connects the API directly from the Jentic API Directory: import it into your self-hosted Jentic One instance and your agent calls the GET /doc/doc operation on demand, without another server's tool definitions sitting in its context.

What query operators does the API support?

Queries support exact phrase quoting, OR statements, source country (sourcecountry), source language (sourcelang), GDELT GKG themes (theme), publisher domain (domain and domainis) and word proximity (near). GDELT requires these operators to be used inside the value of the query parameter rather than as URL parameters of their own; the timespan parameter sets the window inside the rolling 3 months.

Can I limit what my agent is allowed to do with the GDELT DOC 2.0 API?

Yes. Because Jentic One is self-hosted, your own rules decide which operations your agent can call, and GDELT DOC 2.0 exposes only a single read-only search operation, the GET /doc/doc endpoint. When you grant that operation to your agent, it can run news searches and aggregate modes like ArtList, TimelineVol, and TimelineTone through the query parameters, and nothing beyond that one search. Scoping here comes down to whether you allow that one operation at all.