Events & Calendars API
The Events API provides access to community events, concerts, festivals, recurring series, and standard iCalendar feeds.
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /v0.3/events/ | List approved events with pagination and date filters. |
GET | /v0.3/events/{id}/ | Retrieve full event details by UUID. |
GET | /v0.3/search/events/ | Fast Elasticsearch endpoint for spatial radius, date ranges, and keyword searches. |
GET | /v0.3/events/calendar.ics | RFC 5545 standard iCalendar subscription feed. |
GET | /v0.3/events/{slug}/calendar.ics | Single event iCalendar download file. |
1. Search Events (/v0.3/search/events/)
This is the primary endpoint used by Vibemap event embeds and interactive map calendars.
Request
GET https://api.vibemap.com/v0.3/search/events?is_approved=true&point=-84.507078,39.097171&location__geo_distance=50000m__39.097171__-84.507078&end_date__gte=2026-11-18T00:00:00&ordering=start_date&page_size=50 HTTP/1.1
Host: api.vibemap.com
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
search | string | — | Text search matched against event title, description, and performer names. |
is_approved | boolean | true | Only show published, verified events. |
point | string | — | Center point coordinate formatted as lng,lat (e.g. -84.507078,39.097171). |
location__geo_distance | string | — | Geo radius format: <distance>m__<lat>__<lng> (e.g. 50000m__39.097171__-84.507078). |
start_date__gte | string | — | ISO-8601 timestamp for event start cutoff (e.g. 2026-11-18T00:00:00). |
end_date__gte | string | — | Only return events that end on or after this timestamp (filters out past events). |
start_date__lte | string | — | End of date window for upcoming events. |
categories | string | — | Filter by category slug (e.g. arts, music, festivals). |
vibes | string | — | Filter by vibe keyword (e.g. family-friendly, lively, nightlife). |
ordering | string | start_date | Order results: start_date, -start_date, or distance. |
page_size | integer | 50 | Maximum results to return per page. |
Response Example
{
"count": 101,
"results": {
"type": "FeatureCollection",
"features": [
{
"id": "e4920b12-9844-482a-9f5b-9d24a87265c0",
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [-84.5071, 39.0972]
},
"properties": {
"name": "Downtown Holiday Market",
"slug": "downtown-holiday-market",
"description": "Annual festive outdoor market featuring local artisans and live performances.",
"start_date": "2026-11-20T17:00:00-05:00",
"end_date": "2026-11-20T22:00:00-05:00",
"address": "Fountain Square, Cincinnati, OH 45202",
"is_free": true,
"price_display": "Free",
"categories": ["festivals", "shopping"],
"vibes": ["festive", "family-friendly"],
"tickets_url": "https://example.com/tickets",
"recurs": false,
"is_all_day": false,
"timezone": "America/New_York",
"vibemap_images": [
{
"url": "https://images.vibemap.com/events/holiday-market.jpg"
}
]
}
}
]
}
}
2. iCalendar Feeds (/v0.3/events/calendar.ics)
Export events directly to external calendar engines (Google Calendar, Apple Calendar, Microsoft Outlook) using RFC 5545 iCalendar format.
Request
GET https://api.vibemap.com/v0.3/events/calendar.ics?boundary=clermont HTTP/1.1
Host: api.vibemap.com
Response
Returns text/calendar content with standard VEVENT, RRULE, and DTSTART/DTEND timestamps:
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Vibemap//Events//EN
CALSCALE:GREGORIAN
METHOD:PUBLISH
X-WR-CALNAME:Vibemap Events
BEGIN:VEVENT
UID:e4920b12-9844-482a-9f5b-9d24a87265c0@vibemap.com
DTSTAMP:20261118T214844Z
DTSTART:20261120T220000Z
DTEND:20261121T030000Z
SUMMARY:Downtown Holiday Market
DESCRIPTION:Annual festive outdoor market featuring local artisans and live performances.
LOCATION:Fountain Square, Cincinnati, OH 45202
END:VEVENT
END:VCALENDAR