API Documentation

This is temporary, simple documentation. You will find the main endpoints, usage examples with fetch and iFrame, and a sample JSON response. Always use the main domain https://faltapoco.com to integrate the API.

Endpoints

GET /api/countdown/:slug

Returns the countdown data for a slug (for example: navidad).

GET /api/embed/:slug

Returns embeddable HTML (widget) to integrate via iframe.

GET /api/pages

Basic list of pages (slug, title, url).

GET /api/health

Server status (useful for health checks).

📦 iFrame embed

Copy and paste this snippet to embed a countdown anywhere.

<iframe src="https://faltapoco.com/api/embed/navidad" width="320" height="180" frameborder="0"></iframe>

Preview:

Christmas

32d 03h 55m 22s

Embedded example countdown

🔌 Fetch API

Get the countdown data in JSON format to customize it.

fetch("https://faltapoco.com/api/countdown/navidad")
    .then(res => res.json())
    .then(data => console.log(data));

Sample JSON response:

{
  "slug": "navidad",
  "title": "Christmas 2026",
  "targetIso": "2026-12-25T00:00:00Z",
  "days": 99
}

Quick notes and recommendations

We recommend using the main domain https://faltapoco.com for all public API calls.
Use cache headers (e.g. Cache-Control) when integrating the API in high-load environments.
If you need to redraw a countdown on the client, call the endpoint periodically or use the embedded widget.

Try Embed Try Countdown Try All Pages

This is temporary documentation. If you have any doubts or find missing information, contact us.