mygn & rundown.city – Events Hamburg, München, Oldenburg, San Francisco

How busy one day is in a hub of mygn.de (Hamburg, München, Oldenburg + Umland) and rundown.city (San Francisco): the number of events per category, how many are free, how many have a verified location, whether the day is quiet, normal or busy compared with the same kind of day (weekday or weekend) in the next 14 days (unknown for a day further out, where the listings are not complete yet) and top_curated, our editorial picks of the day (occurrence_id, title, starts_at; empty while nothing is rated). Events are counted once per day however many time slots they have. Use it to answer 'is there a lot on this Saturday' before listing events with search_events.

The full record of one event occurrence from search_events, in a hub of mygn.de (Hamburg, München, Oldenburg + Umland) and rundown.city (San Francisco): summary, start and end time, venue with address and coordinates, price text, age_min, the audience block (family, adults_only, visitor_pick, family_p as in search_events; null when not rated), the organiser's link (url), the link to this event's own page on our site or, without one, our hub page (share_url), brand (mygn or rundown) and attribution_url (the hub page to cite as the source), plus the next 20 other dates of the same event (siblings, with siblings_truncated true when there are more). Internal fields (signals, series_kind, kind, title_override) are left out unless verbose is true. all_day true means the occurrence spans the whole day (T00:00 start, ends_at at least 18 hours later). time_unknown true means starts_at is only a date anchor, not a start time: never show 00:00. series_continues true means the listed dates of this recurring event stop only where our sources' look-ahead stops, so it likely runs on: never say it ends after the last listed date. Use url for the organiser's page, where tickets and opening details are.

List the event categories one hub of mygn.de (Hamburg, München, Oldenburg + Umland) and rundown.city (San Francisco) currently has, each with its slug, display label (in the hub's language) and a one-line definition. The slugs are the values for the categories filter of search_events. Typical slugs: party, concert, culture, show, family, food, sport, market, cruise, quiz, tours, other; an event has exactly one.

List the cities (hubs) covered by mygn.de (Hamburg, München, Oldenburg + Umland) and rundown.city (San Francisco): hub slug, display label, timezone and the website of the hub. Pass the slug as hub to the other tools. The hub website is the source to cite.

Search upcoming events in one hub of mygn.de (Hamburg, München, Oldenburg + Umland) and rundown.city (San Francisco) between date_from and date_to in the hub's local calendar. Returns a compact list in time order with at most 50 events per call (default 25); follow next_cursor for more. An event that runs several times on one day (for example 11:00, 13:00 and 15:00) is ONE item whose starts_at and occurrence_id are those of its first slot and whose slots list gives occurrence_id, starts_at and ends_at of every slot; total and paging count items. Each item has occurrence_id, title, display_title, category, starts_at (local time), all_day, time_unknown, venue, is_free, price_text (in the hub's language and currency), attend_mode, share_url (the event's own page on our site or, without one, our hub page, the source to cite), age_min (a stated minimum age, null when the source states none, 0 for all ages), the audience block and tags. The audience block is null when the event is not rated; otherwise family (true: suitable for parents with children, false: not, null: unsure), adults_only (true: an adults-only event, false: not, null: unsure), visitor_pick (0 to 1, how much a first-time visitor would be glad to find it; a ranking hint, not a filter) and family_p (0 to 1, the raw family-friendly probability behind family, for your own threshold). query matches each word on its own in the title and summary (all words first, any word if none has them all; German compounds such as Halloweenparty are split); the words Kinder, Kids, Familie and family do not filter but list family events first, then the rest, each group in the requested sort. time_from and time_to (HH:MM, hub local time) keep the events that start in that range, for 'tonight' or 'in the morning'. Internal fields (editorial score and flags, signals, series_kind, kind, long_running) are left out unless verbose is true. Examples: 'free events this weekend' -> free_only with the weekend dates; 'something for kids on Saturday' -> categories=['family'] for that day; 'concerts tonight' -> categories=['concert'] and time_from='18:00' for today. all_day true means the occurrence spans the whole day (starts_at is the day anchor T00:00 and it ends at least 18 hours later). time_unknown true means starts_at is only a date anchor because no showtime is known: never show 00:00, say the time is not given. Call get_event for the details of events you will mention.