Skip to main content
Home

Free Events API & Calendar Feeds

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

Events

GET/api/events

Upcoming 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 }

GET/api/events/near?lat={lat}&lng={lng}

Events near a point, nearest first. Takes lat, lng and limit.

GET/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.

Calendar feeds (ICS)

GET/api/calendar/{category}.ics

A 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.

Embeds

GET/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.

Using it

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.