Custom APIs, Webhooks & Open Data Feeds
Build bespoke municipal integrations, mobile apps, and civic dashboards with Vibemap open data standards.
Executive Overview
While Vibemap offers turnkey connectors for platforms like Simpleview, CityLight, District360, and WordPress, many partners require custom integrations with proprietary municipal portals, custom mobile apps, or open data initiatives.
Vibemap provides developer-friendly, high-performance APIs adhering to industry standards:
- REST API v0.3: Clean, paginated JSON endpoints for places, events, and thematic collections.
- GeoJSON Standard: Native RFC 7946 GeoJSON FeatureCollections for Leaflet, Mapbox GL, and GIS databases.
- RFC 5545 iCalendar Feeds: Standard calendar feeds compatible with Google Calendar, Apple Calendar, and Microsoft Outlook.
- PostMessage Iframe Bridge: Secure, cross-origin communication between embedded Vibemap widgets and host website shells.
For complete documentation of all parameters, filter types, and response schemas, see the REST API Reference.
Primary Endpoints
1. Boundary-Scoped Events API
Fetch verified events scoped to a specific geographic district:
GET https://api.vibemap.com/v0.3/events?boundary=<slug>&is_approved=true HTTP/1.1
Host: api.vibemap.com
Query Parameters
boundary(string, required): The slug of the district polygon (e.g.downtown-nashville,clermont).is_approved(boolean): Filter for approved events (true).page_size(integer): Number of items per page (default: 50, max: 1000).
For advanced geographic searches and date filtering, see the Events API Reference.
2. Places & Venue Directory API
Search and filter merchant listings:
GET https://api.vibemap.com/v0.3/places/?boundary=<slug>&page_size=50 HTTP/1.1
Host: api.vibemap.com
For full-text search, categories, and vibe filters, see the Places API Reference.
Response Sample (GeoJSON Feature)
{
"type": "Feature",
"id": "c76d29b2-32a1-4384-9036-7c6dfb4c2b9a",
"geometry": {
"type": "Point",
"coordinates": [-86.7785, 36.1627]
},
"properties": {
"name": "Ryman Auditorium",
"slug": "ryman-auditorium",
"address": "116 5th Ave N, Nashville, TN 37219",
"telephone": "(615) 889-3060",
"website": "https://www.ryman.com",
"vibes": ["historic", "live-music", "iconic"],
"categories": ["music", "entertainment"],
"is_closed": false
}
}
3. RFC 5545 Recurring Calendar Feed
For automated ingestion into third-party calendar engines:
GET https://api.vibemap.com/v0.3/events/calendar.ics?boundary=<slug> HTTP/1.1
Host: api.vibemap.com
Delivers a text/calendar response with valid VEVENT, RRULE, EXDATE, and DTSTART/DTEND parameters. For individual event downloads, use /v0.3/events/<slug>/calendar.ics.
Iframe PostMessage Navigation Bridge
When embedding Vibemap interactive widgets inside customer websites, host applications can listen for navigation events:
window.addEventListener("message", function(event) {
if (event.data?.type === "vibemap:navigate") {
console.log("Navigating to:", event.data.url);
}
if (event.data?.type === "vibemap:event-selected") {
console.log("Selected event:", event.data.eventId);
}
});
To obtain an API key for your district or elevated rate limits, contact support@vibemap.com.