How alex9smith/gdelt-doc-api works
gdeltdoc is a Python client for small-scale querying of the GDELT 2.0 Doc API. Users construct Filters, then call article_search or timeline_search; the client sends the encoded query, handles the response, and returns a pandas DataFrame. The library also provides near/repeat query helpers and supports article lists plus five timeline modes. Source excerpts show the request, response processing, and error handling; filter date formatting is supported by the source index, while unsampled implementation details are not expanded.
Main entry points: api_client.py GDELT client · filters.py Filter builder · _version.py Client version · validation.py Tone validation
Components 13
Query client
- GDELT client
gdeltdoc/api_client.py - Article search
gdeltdoc/api_client.py - Timeline search
gdeltdoc/api_client.py - Client version
gdeltdoc/_version.py
Query filters
- Filter builder
gdeltdoc/filters.py - Near/repeat helpers
gdeltdoc/filters.py - Tone validation
gdeltdoc/validation.py - Date formatting
gdeltdoc/helpers.py
Response handling
- HTTP error mapping
gdeltdoc/errors.py - JSON parser
gdeltdoc/helpers.py
Other components
- Python user
- GDELT Doc API
- Pandas DataFrame
Connections 16
- Python user → Filter builder: builds filters
README.md - Python user → Article search: searches articles
README.md - Python user → Timeline search: searches timeline
README.md - Article search → GDELT client: queries ArtList
gdeltdoc/api_client.py - Timeline search → GDELT client: queries mode
gdeltdoc/api_client.py - GDELT client → Filter builder: reads query string
gdeltdoc/api_client.py - Filter builder → Tone validation: validates tone
gdeltdoc/filters.py - Filter builder → Date formatting: formats dates
gdeltdoc/filters.py - Near/repeat helpers → Filter builder: supplies expressions
README.md - GDELT client → Client version: sets user agent
gdeltdoc/api_client.py - GDELT client → GDELT Doc API: sends HTTP query
gdeltdoc/api_client.py - GDELT Doc API → GDELT client: returns response
gdeltdoc/api_client.py - GDELT client → HTTP error mapping: checks response
gdeltdoc/api_client.py - GDELT client → JSON parser: parses content
gdeltdoc/api_client.py - Article search → Pandas DataFrame: returns articles
gdeltdoc/api_client.py - Timeline search → Pandas DataFrame: returns timeline
gdeltdoc/api_client.py