GDELT DOC Search

Core Goal

• Execute atomic DOC API searches against https://api.gdeltproject.org/api/v2/doc/doc.
• Support topic/domain retrieval via explicit query syntax.
• Support both relative windows (timespan) and absolute UTC windows (STARTDATETIME, ENDDATETIME).
• Return structured JSON envelopes and optionally write raw response bytes.
• Keep runtime observable with structured logs and optional log file.

Required Environment

• Configure runtime by environment variables (see references/env.md).
• Start from assets/config.example.env.
• Load env values before running commands:

set -a
source assets/config.example.env
set +a