GDELT
The GDELT collector provides access to the Global Database of Events, Language, and Tone, monitoring the world's news media in over 100 languages.
Capabilities
How Configuration Works
All collectors in Lens adhere to a unified configuration pattern. Instead of hardcoding values, you inject parameters at runtime using the lens.config.yaml file or directly via the ResearchAgent constructor.
Dynamic Configuration
When you initialize a collector, it inspects the configuration object passed to it. This allows for flexible behavior adjustments—such as changing target languages, result limits, or API-specific flags—without modifying the core collector logic. Refer to the central Configuration Reference for the full list of supported parameters available to this collector.
Note: GDELT is a high-volume data source. We recommend using specific keyword filters to prevent noise in your research synthesis.
Schema Mapping
| Source Field | Lens Field | Type |
|---|---|---|
| title | title | string |
| url | source_url | url |
| seendate | timestamp | datetime |
| socialimage | hero_image | url |
Technical Note
GDELT is a high-volume data source. We recommend using specific keyword filters to prevent noise in your research synthesis.