# ScrapeMole Pulse – Public Holiday Date Checker

> ScrapeMole Pulse – Public Holiday Date Checker is a paid API for AI agents from pulse.scrapemole.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-17).

Checks whether a specific date is a public holiday in a given country and returns matching holiday details plus the next upcoming holiday

## Facts

- Endpoint: GET https://pulse.scrapemole.workers.dev/v1/holidays/check?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/scrapemole-pulse-public-holiday-date-checker-2019a693
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RenSxEoXXs7dyl98Xt5LU

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability scrapemole-pulse-public-holiday-date-checker-2019a693
```

Example prompt: Is July 4th 2026 a public holiday in the US? I want to know if it's officially recognised and what type of holiday it is.

## When to prefer this

Use this endpoint when you need to programmatically verify whether a specific date is a public holiday in a specific country, especially for scheduling, payroll, travel planning, or compliance workflows. It covers ~100 countries via Nager.Date, returns typed holiday metadata (Public, Bank, etc.), and includes the next upcoming holiday for forward planning. Prefer over LLM knowledge for authoritative, up-to-date calendar data; prefer over broader holiday-list endpoints when you only need a single date check.

## Known failure modes

- Missing or invalid country code returns a 400 or empty result
- Date format not in YYYY-MM-DD causes a parse error
- Country not covered by Nager.Date (~100 countries supported, some gaps) returns empty holidays array
- Future dates beyond available calendar data may return no results
- Payment failure via x402 returns 402 before any lookup is performed

## How this service works

Pay-per-call "state of the world" lookups that language models cannot know on their own: official ECB exchange rates (latest, historical, conversion), the current time and DST-aware time-zone conversion for scheduling, global weather forecasts (MET Norway, by coordinates or place name), official US National Weather Service forecasts and active watches/warnings/advisories (by state, point, place or zone), the live Hacker News front page, public holidays for ~100 countries (list by year, check a date, next holidays, long weekends, available countries via Nager.Date), and geocoding / reverse geocoding (place or address ↔ coordinates via Photon and Nominatim over OpenStreetMap). Public, non-personal data with sources and licences in every response. USDC via x402, no accounts.

Payments: x402 v2, scheme "exact", USDC on Base (eip155:8453). The payment is verified before the work and settled only when the response is 200. Terms: https://pulse.scrapemole.workers.dev/terms

## Output

Returns a JSON object with: isHoliday (boolean), the list of holidays on that date (name, localName, types, global flag, countryCode), the next upcoming holiday (date and name), source attribution to Nager.Date, and an informational note about regional variation. All data is from Nager.Date covering ~100 countries.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "country",
      "date"
     ],
     "properties": {
      "date": {
       "type": "string",
       "examples": [
        "2026-07-04"
       ],
       "description": "Date to check (YYYY-MM-DD)."
      },
      "country": {
       "type": "string",
       "examples": [
        "US"
       ],
       "description": "ISO 3166-1 alpha-2 country code."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "date": "2026-07-03",
  "next": {
   "date": "2026-07-03",
   "name": "Independence Day"
  },
  "note": "Public holiday calendars for ~100 countries; dates and names may vary by region and year. Informational only.",
  "source": "Nager.Date public holiday API (https://date.nager.at)",
  "country": "US",
  "holidays": [
   {
    "date": "2026-07-03",
    "name": "Independence Day",
    "types": [
     "Public",
     "Bank"
    ],
    "global": true,
    "localName": "Independence Day",
    "countryCode": "US"
   }
  ],
  "isHoliday": true,
  "sourceUrl": "https://date.nager.at"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/scrapemole-pulse-public-holiday-date-checker-2019a693/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pulse.scrapemole.workers.dev](https://www.zero.xyz/host/pulse.scrapemole.workers.dev/llms.txt)