# SofiaStage Agent API

This is a read-only API for Sofia cultural events.

Base URL: https://sofiastage.com/api
OpenAPI: https://sofiastage.com/api/openapi.json

## Endpoints
- GET /health
- GET /v1/meta
- GET /v1/events?date_from=&date_to=&venue=&title=&star=&extra=&extra_id=&limit=&cursor=&include=
- GET /v1/events/{id}?include=
- GET /v1/venues?q=&limit=
- GET /v1/titles?q=&limit=
- GET /v1/stars?q=&limit=
- GET /v1/extras?q=&limit=

## Notes
- Cursor pagination for /v1/events.
- date_from must be on or before date_to when both are provided.
- Cursors are bound to the exact filter set; changing filters with the same cursor returns 400.
- limit values above 100 are clamped to 100.
- /v1/extras and include=extras return article and bottom_article as raw markdown.
- Data is synced from public SofiaStage datapoints.
- This API is parallel to the main SofiaStage app and does not replace legacy endpoints.