# Groundhog Day API

**Provider:** Groundhog Day
**Category:** weather
**Base URL:** `https://virtserver.swaggerhub.com/pcraig3/groundhog-day-api/1.2.1`
**Auth:** none — `# No auth required`
**Rate Limit:** See documentation
**Free Tier:** Yes — available
**Pricing:** Enterprise / contact sales (subscription)
**Docs:** https://groundhog-day.com/api

## Description

This API returns all of North America’s prognosticating animals and their yearly weather predictions.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://virtserver.swaggerhub.com/pcraig3/groundhog-day-api/1.2.1/api/v1` | Root |
| GET | `https://virtserver.swaggerhub.com/pcraig3/groundhog-day-api/1.2.1/api/v1/groundhogs` | Get all groundhogs |
| GET | `https://virtserver.swaggerhub.com/pcraig3/groundhog-day-api/1.2.1/api/v1/groundhogs/{slug}` | Get a groundhog by slug |
| GET | `https://virtserver.swaggerhub.com/pcraig3/groundhog-day-api/1.2.1/api/v1/predictions` | Get predictions for a given year |
| GET | `https://virtserver.swaggerhub.com/pcraig3/groundhog-day-api/1.2.1/api/v1/spec` | Get JSON schema |

## Authentication

No authentication required

```
# No auth required
```

## Sample Request

```bash
curl -X GET 'https://virtserver.swaggerhub.com/pcraig3/groundhog-day-api/1.2.1/api/v1' \
  -H '# No auth required'
```

## Sample Response

```json
{}
```

## Pricing Details

Free — open public API, no authentication required.

---

*Source: [API Map](https://apimap.dev/apis/groundhog-day/) — CC BY 4.0*