API Documentation

Access Groundhog AI Day data programmatically. Perfect for researchers, analysts, and developers building on our accountability infrastructure.

Base URL

https://api.groundhog-ai-day.com/v1

Authentication

Most endpoints are public. Authenticated endpoints require a Firebase ID token in the Authorization header:

Authorization: Bearer YOUR_FIREBASE_ID_TOKEN

Rate Limiting

  • • Public endpoints: 100 requests per minute
  • • Authenticated endpoints: 1000 requests per minute
  • • Bulk exports: 10 requests per hour

Response Format

All responses are JSON with this structure:

{
  "success": true,
  "data": { /* response data */ },
  "meta": {
    "timestamp": "2024-02-02T00:00:00Z",
    "version": "1.0",
    "count": 50
  }
}

Coming Soon

  • • WebSocket API for real-time updates
  • • GraphQL endpoint for flexible queries
  • • Bulk data export endpoints
  • • Prediction submission API (authenticated)

Need an API key?

Public endpoints are available now. For authenticated access and higher rate limits, sign up and generate an API key from your settings page.