OpenAQ Data Fetch

Core Goal

• Query OpenAQ API v3 endpoints for metadata and measurements with one generic client.
• Fetch large historical files from the public OpenAQ S3 archive by prefix or direct key.
• Auto-route requests:
  • API for interactive or filtered queries.
  • S3 for full backfills and partition-based bulk download.
• Keep credentials and region configuration in environment variables.

Required Environment

• OPENAQ_API_KEY (required for API requests).
• OPENAQ_REGION (optional for S3 endpoint selection, defaults to us-east-1 when unset).
• Optional:
  • OPENAQ_S3_BUCKET (defaults to openaq-data-archive).

Reference:

• references/env.md
• assets/config.example.env