GDELT
Search global news coverage and timeline signals from the GDELT DOC 2.0 API.
Tools
| Name | Description |
|---|---|
search_articlesSearch GDELT DOC 2.0 article results for global news coverage. | Search GDELT DOC 2.0 article results for global news coverage. |
article_timelineReturn a raw GDELT DOC 2.0 volume timeline for a query. | Return a raw GDELT DOC 2.0 volume timeline for a query. |
search_imagesSearch GDELT DOC 2.0 image-collage results for a query. | Search GDELT DOC 2.0 image-collage results for a query. |
Triggers
| Name | Description |
|---|---|
new_articlesPoll GDELT for newly seen article URLs after the initial baseline. | Poll GDELT for newly seen article URLs after the initial baseline. |
Quick Start
import { WeavzClient } from '@weavz-io/sdk'
const weavz = new WeavzClient({ apiKey: 'wvz_...' })
const result = await weavz.actions.execute('gdelt', 'search_articles', {
workspaceId: '550e8400-e29b-41d4-a716-446655440000',
integrationAlias: 'gdelt',
input: { /* ... */ },
})Related Integrations
Works well with
Frequently Asked Questions
How do I connect GDELT to my app?
GDELT does not require an external account connection. Install the SDK, add the integration to a workspace, then execute tools programmatically.
What tools does GDELT support?
GDELT supports 3 tools including Search Articles, Article Timeline, Search Images.
Can I use GDELT with AI agents?
Yes. Add GDELT to an MCP server in Tool Mode or Code Mode. Code Mode provides 3 meta-tools with on-demand API discovery so agents can compose stateful workflows without loading every action schema up front.
Can GDELT be used in stateful agent workflows?
Yes. Agents can combine GDELT tools with Filesystem, State KV, Human Gates, input partials, and other workspace integrations while keeping execution scoped to the selected workspace or end user.
What authentication does GDELT use?
GDELT does not require external authentication.
How much does the GDELT integration cost?
The GDELT integration is included on all Weavz plans including the free tier with 20,000 actions per month. No credit card required.
What triggers does GDELT support?
GDELT supports 1 triggers including New Articles.
Connect GDELT in minutes
Get 20,000 free action executions every month. No credit card required.