Groundhog Day API

Name: Groundhog Day API
Brand: Groundhog Day API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentData EnrichmentData Transformationnone5 EndpointsREST

For Agents

Look up groundhogs and Groundhog Day weather predictions from across North America by name, country, or year. No authentication required.

Install Jentic One Beta

Connect the Groundhog Day API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Groundhog Day API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Groundhog Day API.

Retrieve a list of every prognosticating animal on file with profile metadata, region, and historical prediction counts

Fetch a single groundhog by slug (for example punxsutawney-phil or wiarton-willie) including its full prediction history

Filter groundhogs by country to compare US versus Canadian prognosticators in one call

GET STARTED

Start building with Groundhog Day API

Explore with Jentic

View OpenAPI Document

The Groundhog Day API exposes structured data on every prognosticating animal across North America and their annual Groundhog Day weather predictions. The dataset covers around 70 groundhogs and other forecasting critters from the United States and Canada, going back to 1886 for animals like Punxsutawney Phil. Endpoints return groundhog profiles, individual prediction records, and yearly prediction batches filtered by year, country, or species type. The API is open and unauthenticated, making it useful for trivia bots, news-room automation around February 2nd, and educational data projects.

Use Cases

Patterns agents use Groundhog Day API for, with concrete tasks.

★ Newsroom Groundhog Day coverage

Power Groundhog Day news cards, tickers, and morning-show graphics with live data on every prognosticating animal across North America. Editorial teams hit a single endpoint on February 2nd to pull each groundhog's shadow result, location, and historical accuracy without scraping individual ceremony pages. The dataset covers about 70 prognosticators going back to 1886 and is free to use without an API key.

Call GET /api/v1/predictions?year=2024 and produce a ranked list of which prognosticators saw their shadow versus predicted an early spring.

Trivia and chatbot answers

Answer ad-hoc trivia questions about Groundhog Day prognosticators inside chatbots, voice assistants, and Slack apps. The API returns structured profiles for each animal including name, city, region, country, species type and full prediction history, so a bot can answer 'how many times has Phil seen his shadow?' or 'which Canadian groundhog predicted an early spring last year?' without static data. No authentication is needed, which keeps integration to a single HTTP call.

Call GET /api/v1/groundhogs/punxsutawney-phil and answer how many times Phil has seen his shadow over his recorded predictions.

Data journalism and analysis projects

Source clean structured Groundhog Day prediction data for charts, dashboards, and data-journalism stories. The API aggregates predictions from 1886 onwards across roughly 70 animals split between the US and Canada, exposing shadow flags and detail strings that can be piped into Pandas, BigQuery, or a notebook in seconds. Results include geographic metadata so analysts can map prognosticators by region or compare accuracy versus official NOAA winter outcomes.

Fetch all groundhogs via GET /api/v1/groundhogs?country=Canada and compute the share that predicted an early spring in 2023.

AI agent integration through Jentic

Expose the Groundhog Day API as an agent tool through Jentic so language-model agents can answer Groundhog Day questions during their reasoning. The agent searches Jentic for an intent like get the latest groundhog prediction, loads the matching operation schema, and executes the GET /api/v1/predictions call without the developer hand-writing any HTTP client code. Because the API requires no auth, the only setup step is the Jentic search-load-execute call.

Through Jentic, search for 'get groundhog day prediction', load the predictions operation, and execute it for the current year.

Key Endpoints

5 endpoints — the groundhog day api exposes structured data on every prognosticating animal across north america and their annual groundhog day weather predictions.

METHOD

PATH

DESCRIPTION

GET

/api/v1/groundhogs

List every prognosticating animal with predictions

GET

/api/v1/groundhogs/{slug}

Get a single groundhog and its prediction history

GET

/api/v1/predictions

Get all predictions for a given calendar year

GET

/api/v1/spec

Download the OpenAPI/YAML schema

GET

/api/v1

Root welcome endpoint with HATEOAS links

GET

/api/v1/groundhogs

List every prognosticating animal with predictions

GET

/api/v1/groundhogs/{slug}

Get a single groundhog and its prediction history

GET

/api/v1/predictions

Get all predictions for a given calendar year

GET

/api/v1/spec

Download the OpenAPI/YAML schema

GET

/api/v1

Root welcome endpoint with HATEOAS links

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The Groundhog Day API requires no vendor credentials, so Jentic only manages the Jentic agent key (ak_*) used to call the platform. There are no Groundhog Day secrets to leak or rotate.

Intent-based discovery

Agents search Jentic with intents like 'get the latest groundhog prediction' or 'list groundhogs by country' and Jentic returns the matching operation schema (GET /api/v1/predictions or GET /api/v1/groundhogs) ready to execute.

Time to first call

Direct integration is already trivial because the API is unauthenticated. Through Jentic, an agent can discover and call it in under five minutes via search-load-execute, with structured input schemas instead of free-form documentation reading.

FAQs

Specific to using Groundhog Day API through Jentic.

What authentication does the Groundhog Day API use?

The Groundhog Day API is open and requires no authentication or API key. Agents can call GET /api/v1/groundhogs and GET /api/v1/predictions directly. When routed through Jentic the call still requires no vendor credentials, only a Jentic agent key (ak_*) for the Jentic platform itself.

Can I get every groundhog and its prediction history in one call?

Yes. GET /api/v1/groundhogs returns the full list of prognosticators with embedded prediction arrays, and supports country and isGroundhog query filters so you can narrow down to Canadian animals or non-groundhog species without a second request.

What years of Groundhog Day predictions does this API cover?

The dataset starts in 1886 with Punxsutawney Phil and runs through the most recent Groundhog Day. The /api/v1/predictions endpoint validates a year query parameter and rejects anything below 1886, so older years return a 400 error rather than empty data.

Are there rate limits on the Groundhog Day API?

The published spec does not document hard rate limits. The API is hosted as a free public service, so treat it accordingly: cache results, batch requests where possible, and avoid hammering it during the February 2nd traffic spike.

How do I look up a single groundhog through Jentic?

Install Jentic with pip install jentic, then run a search for 'get a groundhog by slug', load the matching operation, and execute it with the slug parameter (for example punxsutawney-phil). Jentic handles the request to GET /api/v1/groundhogs/{slug} and returns the parsed groundhog object.

Is the Groundhog Day API free?

Yes. It is a free community API maintained at groundhog-day.com with no paid tier or API key requirement, which is why it is well suited to demos, hackathons, and lightweight agent integrations.