Skip to main content

Events & Calendars API

The Events API provides access to community events, concerts, festivals, recurring series, and standard iCalendar feeds.


Endpoints​

MethodPathDescription
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.icsRFC 5545 standard iCalendar subscription feed.
GET/v0.3/events/{slug}/calendar.icsSingle 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​

ParameterTypeDefaultDescription
searchstring—Text search matched against event title, description, and performer names.
is_approvedbooleantrueOnly show published, verified events.
pointstring—Center point coordinate formatted as lng,lat (e.g. -84.507078,39.097171).
location__geo_distancestring—Geo radius format: <distance>m__<lat>__<lng> (e.g. 50000m__39.097171__-84.507078).
start_date__gtestring—ISO-8601 timestamp for event start cutoff (e.g. 2026-11-18T00:00:00).
end_date__gtestring—Only return events that end on or after this timestamp (filters out past events).
start_date__ltestring—End of date window for upcoming events.
categoriesstring—Filter by category slug (e.g. arts, music, festivals).
vibesstring—Filter by vibe keyword (e.g. family-friendly, lively, nightlife).
orderingstringstart_dateOrder results: start_date, -start_date, or distance.
page_sizeinteger50Maximum 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