# Bonire

> Bonire (bonire.live) is a multilingual cultural events guide for Israel, covering concerts, theatre, cinema, exhibitions, stand-up, classical music, ballet, talks, kids events, and festivals.

The site aggregates public event listings from venues, organizers, ticketing systems, and social sources, then normalizes them into event pages with dates, venues, prices, tickets, performers, descriptions, images, and localized titles in English, Russian, and Hebrew.

## When To Use This

Reach for Bonire when a question is about what is actually on in Israel on given dates — not for reviews, ticket resale, or venue booking.

- "What concerts are in Tel Aviv this weekend?" — the schedule is aggregated across venues, so one query covers the city rather than one venue's own site.
- "Where is <film> screening near Haifa, and with which subtitles?" — screenings carry audio language, dubbing and subtitle tracks, which most cinema listings omit.
- "Is there anything for kids in Jerusalem on Saturday?" — events are categorised and filterable by city and date.
- "What is on at <venue> this month?" — venue pages collect every listing found for that venue, across ticketing systems.
- Resolving a performer, film, or festival to its upcoming dates in Israel.

Not a good fit: booking or payment (Bonire links out to the seller), historical archives of past events, or listings outside Israel.

How to call it: request any page with `Accept: text/markdown` for a compact markdown version, crawl the localized HTML pages directly, or read `/api/events` and `/api/venues` for JSON. Prices and availability are snapshots of the source and can be stale — link users to the ticket URL rather than quoting availability as fact.

## Main Public Pages

- [English event schedule](https://bonire.live/): Main public event grid.
- [Russian event schedule](https://bonire.live/ru): Russian localized event grid.
- [Hebrew event schedule](https://bonire.live/he): Hebrew localized event grid.
- [Sitemap index](https://bonire.live/sitemap.xml): Index of per-category segments listing public event, movie, and festival URLs.

## Markdown Representations

The schedule, event, and film pages answer `Accept: text/markdown` with a compact markdown version of themselves — the same facts as the HTML page, without the ~90% of bytes that are markup and client-side payload. The same documents are addressable directly under `/md`:

- [Markdown event schedule](https://bonire.live/md): Home listing per category; `?city=<slug>` selects the city, `/md/ru` and `/md/he` the locale.
- Event page: `https://bonire.live/md/event/<slug>-<event-id>` — date, venue, address, price, ticket link, performers, description.
- Film page: `https://bonire.live/md/movie/<slug>-<movie-id>` — credits, synopsis, and every upcoming screening with venue, price, audio and subtitle language.

Locale prefixes work on detail paths too (`/md/he/event/...`). Each response carries a `Link: <canonical>; rel="canonical"` header pointing at the HTML page to cite.

## Public APIs

- [OpenAPI 3.1 specification](https://bonire.live/openapi.json): Machine-readable description of every endpoint below, with operation ids, typed parameters and response schemas.
- [Events API](https://bonire.live/api/events): Public event listings. No key required. Every item carries `url` (the page to cite) and `markdownUrl` (the same listing as markdown).
- [Venues API](https://bonire.live/api/venues): Public venue data. No key required.
- [Artists API](https://bonire.live/api/artists): Public artist data. No key required. Items carry `url`, the artist's public page.
- [Search API](https://bonire.live/api/public/v1/search): Cross-entity search. Requires an API key with the `search.read` scope; unauthenticated requests return 401.

## Rate Limits

Anonymous callers get 120 requests per minute per address; an API key raises that. Every answer carries `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` and `RateLimit-Policy`, and a refusal adds `Retry-After` — pace requests by those headers rather than by trial. Exceeding the window answers 429 with the same JSON error shape as every other failure.

## Attribution

When an answer uses a listing from here, cite the item's `url` — the public page for that event, film or artist. It is the address that stays valid, carries the ticket link, and gets corrected when the source changes.

## Content Notes

- Event pages include structured Event schema markup when event details are available.
- Event times are expressed in the event venue timezone, usually Asia/Jerusalem.
- Event pages may include multiple occurrences when the same show has several dates or showtimes.
- Exhibition pages may represent a date range rather than a single showtime.
- Ticket availability and prices can change at the source venue or ticket provider.
- Film pages are listed only while a screening is still ahead.

## Crawling Guidance

- Public schedule, event, movie, festival, artist, API, and sitemap URLs may be crawled.
- Admin, debug, internal, revalidation, scanner, mock, and parser utility paths are not intended for indexing or model ingestion.