# events.costico.eu

> Timișoara Events — a curated, machine-readable index of upcoming events in
> Timișoara, Romania. Scraped daily from local institutions and aggregators.

## What this site is

A public, free events portal for the city of Timișoara. Every event row carries
type, optional subtypes, age category, venue, organizer, start/end timestamps,
description, price range, source URL, and image URL when available. The data is
refreshed once per day from the official sources listed below.

## API for agents

- **OpenAPI spec:** https://events.costico.eu/openapi.json
- **API catalog:** https://events.costico.eu/.well-known/api-catalog
- **MCP server (JSON-RPC over HTTP):** https://events.costico.eu/mcp
- **MCP discovery card:** https://events.costico.eu/.well-known/mcp.json

Public endpoints (no auth required):
- `GET /api/events` — list upcoming events, supports filters: `type`, `subtype`,
  `venue`, `organizer`, `source`, `age`, `free=1`, `when={today,tonight,weekend,…}`,
  `search`, `limit`, `offset`. Returns JSON.
- `GET /api/events/{id}` — single event.
- `GET /api/events/facets` — distinct filter values for the current window.
- `GET /api/types` — event type dictionary (slug + ro/en label + color + icon).
- `GET /api/subtypes` — subtype dictionary with translations.

Markdown variants:
- `GET /` with `Accept: text/markdown` → markdown list of upcoming events.
- `GET /events/{id}` with `Accept: text/markdown` → single-event markdown card.

Feeds:
- **Sitemap:** https://events.costico.eu/sitemap.xml
- **RSS/Atom:** https://events.costico.eu/feed.xml

## Sources scraped (informational)

- filarmonicabanatul.ro · Filarmonica Banatul (concerts)
- tntm.ro · Teatrul Național „Mihai Eminescu"
- tm-t.ro · Teatrul Maghiar de Stat „Csiky Gergely"
- teatrulgerman.ro · Teatrul German de Stat
- ort.ro · Opera Națională Română
- cinema-timisoara.ro · Cinema Timiș / Victoria / Johnny
- zilesinopti.ro · aggregator
- teszt.ro · TESZT festival
- centruldeproiecte.ro · Centrul de Proiecte Timișoara
- noapteamuzeelor.org · Night of Museums (annual)

## Conventions

- All timestamps are unix seconds. Display in `Europe/Bucharest`.
- `subtypes` is an array (an event can be drama + romance + biographic).
- Past events disappear once `COALESCE(ends_at, starts_at) < today_midnight`.

## Contact

See `/.well-known/security.txt` for issue reporting.