Every endpoint below is read-only, needs no key and no signup, sends Access-Control-Allow-Origin: * so a browser can call it directly, and returns JSON unless stated otherwise. Base URL: https://countdownboxes.app
/api/eventsUpcoming events, newest deadline first. Returns a cursor for the next page.
category · search · cursor · limit · country · city · live · sort · lifecycle · offset
category takes one of SPORTS, MUSIC, TECHNOLOGY, LIFESTYLE, RELIGION, FILM, TV, ANIME, GAMING, SPACE, CRYPTO, CULTURE, FESTIVALS. limit is capped server-side. lifecycle is upcoming, now or past.
Response: { events: Event[], total: number, nextCursor?: string }
/api/events/near?lat={lat}&lng={lng}Events near a point, nearest first. Takes lat, lng and limit.
/api/search?q={query}Diacritic-insensitive search across title, city, country and tags — an ASCII query matches a stored diacritic, so krakow finds Kraków.
Rate limited to 30 requests per minute per IP. The other endpoints on this page are not rate limited; please be reasonable.
/api/calendar/{category}.icsA subscribable iCalendar feed that keeps updating itself. Subscribe once in Google Calendar, Apple Calendar or Outlook and new events appear automatically.
sports · music · technology · lifestyle · religion · film · tv · anime · gaming · space · crypto · culture · festivals · all
Browse them at /calendar/all.
/api/oembed?url={countdownUrl}Standard oEmbed (version 1.0, type rich) for any countdown page URL on this site. format must be json.
For a plain iframe instead, see the widget page.
No key, no quota to request, no account. If you build something on it, a link back is appreciated but not required. Event data comes from public providers and is passed through with its own source noted on each record — sourceApi tells you where a row came from.
There is no stability guarantee: these routes serve the site itself, so fields may be added. Existing fields are not renamed without reason.