Програма на Театри, Балет, Опера, Мюзикъл, Концерти в София

# SofiaStage Agent API > Read-only index for SofiaStage cultural-event data exposed by the Cloudflare Worker API. Use this file as a compact navigation layer for agents. Use OpenAPI for full schema and field-level details. ## Policies - All /v1/* endpoints are read-only and do not require user authentication. - /v1/events uses cursor pagination; cursors are valid only for the same filter set. - Supported include values are stars and extras. - Date format is YYYY-MM-DD and date_from must be <= date_to. - Start-time filters: starts_after and starts_before are inclusive and support HH:mm, local YYYY-MM-DDTHH:mm with tz (default Europe/Sofia), or RFC3339 with offset/Z. - limit values above 100 are clamped to 100. - Rate guidance: keep automated traffic polite (about 1-3 requests/second per client) and use exponential backoff on 429/5xx responses. - Caching guidance: respect Cache-Control headers (events: max-age=60, lookups/detail/meta: max-age=300, discovery docs: max-age=3600). - Stability guidance: /v1/* read endpoints and response envelopes are stable integration targets; /v1/admin/sync is outside normal public read workflows. - Attribution guidance: preserve canonical_url/info_url/ticket_url fields when redistributing results and attribute SofiaStage as the aggregator. - Non-ASCII query values (for example Cyrillic) must be URL-encoded by the client. - Extras content fields (article, bottom_article) are Markdown. - Star/extra slug detail routes rely on snapshots; missing snapshot rows return 404. ## Core - [OpenAPI schema](https://sofiastage.com/api/openapi.json): Complete machine-readable contract. - [Health check](https://sofiastage.com/api/health): Liveness and deploy status. - [Metadata](https://sofiastage.com/api/v1/meta): Snapshot/version metadata and record counts. - [Events feed](https://sofiastage.com/api/v1/events): Primary collection with filtering and pagination. - [Events example (live date range + includes)](https://sofiastage.com/api/v1/events?da

{"openapi":"3.1.0","info":{"title":"SofiaStage Agent API","version":"1.7.0","description":"Read-only filtered API for SofiaStage events, venues, titles, stars and extras."},"servers":[{"url":"https://sofiastage.com/api"}],"tags":[{"name":"system","description":"Service metadata and discovery endpoints."},{"name":"events","description":"Event retrieval endpoints."},{"name":"lookup","description":"Aggregated lookup lists for venues, titles, stars and extras."},{"name":"admin","description":"Sync o