{"uid":"cap_tJXvV_0KxYAmNUp3aHWTM","slug":"scrapemole-pulse-public-holidays-lookup-2727f0b3","name":"ScrapeMole Pulse: Public Holidays Lookup","description":"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.\n\nPayments: 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","url":"https://pulse.scrapemole.workers.dev/v1/holidays?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"],"properties":{"year":{"type":"string","examples":["2026"],"description":"Calendar year (default current UTC year)."},"country":{"type":"string","examples":["LT"],"description":"ISO 3166-1 alpha-2 country code."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"note":"Public holiday calendars for ~100 countries; dates and names may vary by region and year. Informational only.","year":2026,"count":14,"source":"Nager.Date public holiday API (https://date.nager.at)","country":"LT","holidays":[{"date":"2026-01-01","name":"New Year's Day","types":["Public"],"global":true,"localName":"Naujieji metai","countryCode":"LT"}],"sourceUrl":"https://date.nager.at"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8wtDEBnUEcHzL5-YDBKK9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the list of public holidays for a given country and year, powered by Nager.Date, covering ~100 countries.","exampleAgentPrompt":"What are all the public holidays in Lithuania for 2026? I need the official dates and names from Nager.Date.","exampleUseCases":[{"title":"Travel itinerary holiday awareness","prompt":"I'm planning a business trip to France in March 2026 — can you pull up all the French public holidays that year so I know which days to avoid scheduling meetings?"},{"title":"Payroll calendar for remote team","prompt":"We have employees in Poland and need to set up our 2026 payroll calendar — can you list all official Polish public holidays for 2026?"},{"title":"Long weekend planning in Japan","prompt":"What are Japan's public holidays in 2025? I want to see which ones fall near weekends so I can plan some long weekend trips."}],"resultDescription":"A JSON object containing the country code, year, count of holidays, and an array of holiday objects each with date (ISO 8601), English name, local name, holiday type(s), global flag, and country code. Also includes the Nager.Date source URL and an informational note about regional variation.","failureModes":["Missing or invalid country code returns an error — must be ISO 3166-1 alpha-2","Unsupported country (not in Nager.Date's ~100-country list) returns no holidays or an error","Invalid year format may result in a bad request error","Payment not fulfilled (402) prevents the call from completing","Network or upstream Nager.Date outage may cause 5xx errors"],"whenToPreferThis":"Use this endpoint when you need authoritative, structured public holiday data for scheduling, payroll, travel planning, or compliance across ~100 countries, without maintaining your own holiday database. Prefer it over LLM knowledge (which may be outdated or hallucinated) or scraping official government sites. Ideal for AI agents that need real-time, up-to-date holiday calendars on a pay-per-call basis with no account setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T18:40:37.827Z","isFirstParty":false,"canonicalSlug":"scrapemole-pulse-public-holidays-lookup-2727f0b3"}