PURPOSE: Find upcoming Christian gatherings posted on The Living Bread (services, prayer nights, Bible studies, worship nights, meals, recovery groups), soonest first. WHEN TO USE: "something on tonight in Atlanta", "church events this week near Austin", "an online service I can join". WHEN NOT: church buildings: find_churches. Ongoing groups: find_communities. A person to pray with now, or Tables open now: find_people_to_pray_with. MODES (required parameters in brackets): tonight [city] the next hours in one city, matched as text (hours 1 to 36, default 12; country disambiguates). this_week [none] the next seven days within 250 km of lat and lng or city, online gatherings included (limit up to 20, default 10). any [none] a custom window (days 1 to 60, default 14) near a place or anywhere; online true lists only online gatherings; paged with limit and cursor. OUTPUT: mode, answered_by, and count, gatherings [{id, title, when_utc, where, distance_km, kind, online, good_for_a_first_visit, freshness}], the door to every gathering, next_cursor for any, and honest when nothing is held. BEHAVIOR: read only; reads live data. Times are UTC and are what hosts posted: freshness is scheduled with available_now false, never a confirmation it is happening; convert to the person's time before telling them. None returns count 0 and suggests online gatherings. The place words (never a user id) are logged anonymously. Parameters a mode does not use are ignored and named in ignored_params. Access: no sign-in; shared limit of 300 requests a minute per IP.
